Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > Medusa



  1. Install pip for python3 (if you haven't already)

       curl -s https://bootstrap.pypa.io/get-pip.py | python3 - --user
  2. Add it to your PATH (if you haven't already)

      echo "PATH=\$HOME/.local/bin:\$PATH" >> ~/.bashrc && source ~/.bashrc


  1. Download Medusa.

     git clone git://github.com/pymedusa/Medusa.git
  2. Install python module dependencies

     pip3 install --user -U -r Medusa/requirements.txt
  3. Start Medusa in daemon mode to create the initial configuration files.

     python3 ~/Medusa/start.py -d
  4. Kill the Medusa process.

     pkill -f start.py
  5. Edit the configuration file to set a port and download location. Port 10679 has been automatically generated for you, but you may use another 5 digit port between 10000 and 65535.

     nano ~/Medusa/config.ini

    Change the line that reads root_dirs = "" to root_dirs = "0|/home/user/files".
    Change the "web_port" option to 10679 or your chosen port. Set a username and password for the web interface by editing web_username = "user" and web_password = "your password here"

  6. Change Your Bash Timezone. If you haven't set your Bash Timezone, your logs and television schedule will be incorrect.

  7. Start Medusa

     python3 ~/Medusa/start.py -d --nolaunch

Automatically Restart

Below are steps to take to have your Medusa instance automatically restart if it crashes, or if the server is rebooted.

  1. Make a file to be used for the script. touch ~/medusa_restart.cron

  2. Edit the file and enter the text below. nano -w ~/medusa_restart.cron

    if pgrep -fx "/usr/lib/python-exec/python3.8/python3 /home/user/Medusa/start.py -d --nolaunch" > /dev/null
        echo "Medusa is running."
        echo "Medusa is not running, starting Medusa"
         python3 ~/Medusa/start.py -d --nolaunch
  3. Save the file with Ctrl+x, y and Enter to accept overwriting.

  4. Make the script executable. chmod +x ~/medusa_restart.cron

  5. Open your crontab. EDITOR=nano crontab -e

  6. Enter the following text at the end of the file.

    @reboot /home/user/medusa_restart.cron >/dev/null 2>&1
    */5 * * * * /home/user/medusa_restart.cron >/dev/null 2>&1
  7. Save the crontab with Ctrl+x, y and Enter to accept overwriting.


  • Open your browser and navigate to http://server.whatbox.ca:10679 to access the Medusa web interface.