Our search function may intermittently fail to display results. If this happens, try refreshing the page, as this usually resolves the issue. We’re working on a permanent fix. Thank you for your patience!
Medusa
Initial Setup
In this guide, we'll be setting up Medusa for the first time. This guide assumes that this is your first time installing Medusa, and you'll be storing your media locally, saving it to ~/media/TV Shows.
We will be doing the following:
- Add root folder
- Connecting your download clients and setting their completed download directories for Medusa Post-Processing
- Configure Post-Processing
Add Root Folder
- Access and log in to your Medusa instance using the credentials you set during installation.
- Hover your mouse pointer over the Settings Gear then click on General.
- Scroll down to the end of the first section to where you see Show root directories and then click New.
- This will bring up the Directory Browser window.
- Then, select your
usernamedirectory. - Next, select the
mediadirectory. - Next, chose the correct directory.
- To select the directory, click OK.
- Finally, click on Set as Default, and then Save Changes.
Configure Download Client
- Hover your mouse pointer over the Settings Gear icon, then click on Search Providers.
Torrent Clients
- In Search Settings to add a Torrent download client, click on the Torrent Search tab.
Deluge WebUI
Search .torrent files: ENABLED
Send .torrent files to: Deluge (via WebUI)
Deluge: https://username.server.usbx.me/deluge/
Deluge Password: As configured in UCP under DelugeDeluge Daemon
Search .torrent files: ENABLED
Send .torrent files to: Deluge (via Daemon)
Deluge: http://{servername}.usbx.me:webui_port
Deluge: Username: {username}
Deluge Password: As configured in UCP under DelugerTorrent
Search .torrent files: ENABLED
Send .torrent files to: rtorrent
rTorrent host:port: https://{username}.{servername}.usbx.me/rutorrent/plugins/httprpc/action.php
Http Authentication: Basic
Verify Certificate: YES
rTorrent Username: {username}
rTorrent Password: As configured in UCP under ruTorrent
Add Label To Torrent: Medusa
Downloaded Files Location: <EMPTY>qBittorrent
Connection Settings:
Search .torrent files: ENABLED
Send .torrent files to: Qbitorrent
Qbitorrent host:port: https://{username}.{servername}.usbx.me/qbittorrent/
Verify certificate: unticked
Qbitorrent Username: {username}
Qbitorrent Password: As configured in UCP under Qbitorrent
Add Label To Torrent: Medusa
Downloaded Files Location: <EMPTY>Post-Processing Setup:
- Access and log in to your ruTorrent instance using the credentials you set during installation.
- Go to Settings by clicking the Gear Icon.
- Click on the Autotools section in the left column.
- Enable the checkbox that says
Enable "Automove" if torrent's label matches filterand change default entry/.*/to/Medusa/. - Click the directory button next to Path to finished downloads.
- Upon clicking the directory button, it will auto-fill the default download path your ruTorrent is using. This default location is:
/home/{USERNAME}/files. - add
/completedto the end of the Path, making the Path:/home/{USERNAME}/files/completed.
Transmission
Connection Settings:
Search .torrent files: ENABLED
Send .torrent files to: Transmission
Transmission host:port: https://{username}.{servername}.usbx.me
Transmission RPC URL: transmission/rpc
Transmission Username: {username}
Transmission Password: As configured in UCP under Transmission
Downloaded Files Location: EMPTYPost-Processing Setup:
Transmission appends .part to the downloading file extensions until the download is completed, and Medusa will ignore these files with .part extensions, so there is no need to configure any further Post Processing directory settings for this client
Usenet Clients
- In Search Settings, to add a Usenet download client, click on the NZB Search tab.
NZBGet
Connection Settings:
Search NZBs: ENABLED
Send .nzb files to: NZBGet
Host: {username}.{servername}.usbx.me/nzbget
Connect using HTTPS: ENABLED
Username: {nzbget username}
Password: {nzbget password}
Use NZBget category: Medusa
Use NZBget category (backlog episodes): Medusa
Use NZBget category for anime: Medusa-Anime
Use NZBget category for anime (backlog episodes): Medusa-AnimePost-Processing Setup:
- Access and log in to your NZBget instance using the credentials you have set in the application.
- Go to Settings In the top right corner of the menu at the top of the initial login page.
- From here, click on the PATHS link in the menu on the left column menu
- Here, you will see MainDir location default as
/downloads
- MainDir needs the full Path of the
filesdirectory in your home. For example:/home/{USERNAME}/files/
- Scroll down to the bottom of the page to click Save all changes in the lower-left corner
SABnzbd
Connection Settings:
Search NZBs: ENABLED
Send .nzb files to: SABnzbd
Host: {username}.{servername}.usbx.me/sabnzbd/
Username: {sabznbd username}
Password: {sabnzbd password}
SABnzbd : {sabnzbd api key}
Use SABnzbd category: Medusa
Use SABnzbd category (backlog episodes): Medusa
Use SABnzbd category for anime: Medusa-Anime
Use SABnzbd category for anime (backlog episodes): Medusa-AnimeIt is vital to have the trailing / on the end of your SABnzbd host. Otherwise, Medusa will fail to add NZBs successfully to this client.
Post-Processing Setup:
- Access and log in to your SABbzbd instance using the credentials you have set in the application.
- Go to Settings In the top right corner of the menu at the top of the initial login page.
- Next, click the Folders link.
- From here you will see the 2 default directories that need to be changed:
- Temporary Download Folder:
/home/{USERANME}/Downloads/incomplete - Completed Download Folder:
/home/{USERANME}/Downloads/complete - These 2 default directories need to be set to:
- Temporary Download Folder:
/home/{USERANME}/incomplete - Completed Download Folder:
/home/{USERANME}/files/completed
Post-Processing Settings
- Hover your mouse pointer over the Settings Gear then click on Post-Processing.
- Enable Scheduled Post-Processor.
- Click on the directory browser button for Post-Processing Dir.
- Using the blue directory icons, navigate to your
/home/{USERNAME}/files/completed.
- To save the
Post-Processing Dirclick OK in the directory browser dialog box.
- You will need to set the Processing Method:
- Processing Method: HARD LINK
- This method is recommended if you are using local storage on your slot.
- Hard Links effectively creates a file that points directly to your source file in the disk. You can do anything to this file without affecting your source file and vice versa. This is useful when you're seeding from torrents.
- Processing Method: COPY
- This method is required if you use a separate file system mount such as mergerfs.
- Hard Links does not work on mounts, so Copy is recommended if you have a mount.
- For this, consider using Rclone VFS and MergerFS Setup
If your data has archives, it would be recommended to enable Medusa's Unpack feature:
- To save your Post Processing settings, click on the Save Changes button below the provider list, and then click the Save Changes button in the lower-left corner.
- For the Post Processing scheduler to be enabled, you must restart Medusa. You can do this easily by hovering your mouse pointer over the Configuration Tool icon and then click on Restart.
If you require further assistance, you can open a support ticket here!
Feedback and suggestions regarding this article are welcome on our Discord server