Template:FAQ

No description.

Template parameters

Parameter		Description	Type	Status
ARRNAME	ARRNAME	Name of the App Example Radarr	String	required
ARRDISCORD	ARRDISCORD	Link to Discord	Unknown	optional
ARRPORT	ARRPORT	Default Port	Unknown	optional

General FAQs

Can I update Template:ARRNAME inside my Docker container?

[[#can_i_update_Template:ARRNAME_inside_my_docker_container|anchor]]

• Technically, yes. But you should absolutely not. It is a primary philosophy of Docker. Database issues can be caused for Template:ARRNAME if you upgrade your installation inside to the most recent nightly, then update the docker container itself which might downgrade to an older version.

Help, My Mac says Template:ARRNAME cannot be opened because the developer cannot be verified

[[#help_my_mac_says_Template:ARRNAME_cannot_be_opened_because_the_developer_cannot_be_varified|anchor]]

• This is simple, please see this link for more information here

Developer Cannot be verified

How do I request a feature for Template:ARRNAME?

[[#how_do_i_request_a_feature_for_Template:ARRNAME|anchor]]
This is an easy one click Template:ARRNAME/Template:ARRNAME/issues/new?assignees=&labels=feature+request&template=feature_request.md&title= here

I am getting an error: Database disk image is malformed

anchor

• This means your SQLite database that stores most of the information for Template:ARRNAME is corrupt.
  • There is an excellent guide here to copy the contents from the corrupt database into a new one: http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html
  • Alternatively, you can follow these instructions here

• Another possible cause of you getting an error with your Database is that you're placing your database on a network drive (nfs or smb or something else not local). Simple answer to this is to not do this as SQLite and network drives not typically play nice together and will cause a malformed database eventually. Template:ARRNAME's config folder must be on a local drive. If you're trying to restore your database you can check out our Backup/Restore guide here.

• If you are using mergerFS you need to remove direct_io as sqlite uses mmap which isn’t supported by direct_io as explained in the mergerFS docs here

I use Template:ARRNAME on a Mac and it suddenly stopped working. What happened?

[[#i_use_Template:ARRNAME_on_a_mac_and_it_suddenly_stopped_working_what_happened|anchor]]

• Most likely this is due to a MacOS bug which caused one of the Template:ARRNAME databases to be corrupted. Follow these steps to resolve:

1. In the Finder, select the Go menu, and the option Go to Folder...
2. Enter ~/.config/Template:ARRNAME and click the Go button to open Template:ARRNAME's data folder
3. Move the following files to Trash: logs.db, logs.db-journal
4. Attempt to launch Template:ARRNAME and see if it works. If so, congrats!
5. If not, then the log DB didn't get corrupted, and it might have been the primary database. You will need to restore from backup.
6. Move the following files to Trash: Template:ARRNAME.db, Template:ARRNAME.db-journal
7. Open the Backups folder you see and find the .zip archive with the most recent date. Decompress it. Move everything from the resulting folder into the main Template:ARRNAME data folder, over-writing any files.
8. Attempt to launch Template:ARRNAME and see if it works. If it does not work, you'll need further support. Post in our Template:ARRNAME reddit or hop on [[[:Template:ARRDISCORD]] discord] for help.

Why can’t Template:ARRNAME see my files on a remote server?

[[#why_cant_Template:ARRNAME_see_my_files_on_a_remote_server|anchor]]
This can be for various reasons, but the most common is, Template:ARRNAME is running as a service, which causes one of two things:

1. Template:ARRNAME runs under the LocalService account by default which doesn’t have access to protected remote file shares.

   Solutions:

   • Run Template:ARRNAME’s service as another user that has access to that share How to change a service’s user account
   • Run Template:ARRNAME.exe using the Startup Folder

2. You’re using a mapped network drive (not a UNC path)

   Solutions:

   • Change your paths to UNC paths (\\server\share)
   • Run Template:ARRNAME.exe via the Startup Folder

How do I Backup/Restore my Template:ARRNAME?

[[#how-do-i-backup-restore-my-Template:ARRNAME|anchor]]

Backing up Template:ARRNAME

• Using built-in backup

1. Go to System: Backup in the Template:ARRNAME UI
2. Click the Backup button
3. Download the zip after the backup is created for safe keeping

[[File:how-do-i-backup-restore-my-Template:ARRNAME.gif|750px|alt=Backup Template:ARRNAME|Backup Template:ARRNAME]]

• Using file system directly

1. Find the location of the AppData directory for Template:ARRNAME
   • Via the Template:ARRNAME UI go to System: About
   • [[Template:ARRNAME Appdata Directory]]
2. Stop Template:ARRNAME - This will prevent the database from being corrupted
3. Copy the contents to a safe location

Restoring from Backup

Restoring to an OS that uses different paths won’t work (Windows to Linux, Linux to Windows, Windows to OS X or OS X to Windows), moving between OS X and Linux may work, since both use paths containing / instead of \ that Windows uses, but is not supported.

• Using zip backup

1. Re-install Template:ARRNAME
2. Run Template:ARRNAME
3. Navigate to System > Backup
4. Select Restore Backup
5. Select Chose File
6. Select your backup zip file
7. Select Restore

[[File:Template:ARRNAME-restore-using-zip-backup.gif|750px|alt=Restore Using zip Backup]]

• Using file system backup

1. Re-install Template:ARRNAME
2. Run Template:ARRNAME once to get the AppData directory location
3. Stop Template:ARRNAME
4. Delete the contents of the AppData directory (Including the .db-wal/.db-journal files if they exist)
5. Restore from your backup
6. Start Template:ARRNAME
7. As long as the paths are the same, everything will pick up where it left off

• Restore for Synology NAS

CAUTION: Restoring on a Synology requires knowledge of Linux and Root SSH access to the Synology Device.

1. Re-install Template:ARRNAME
   

2. Run Template:ARRNAME once to get the AppData directory location
   

3. Stop Template:ARRNAME
   

4. Connect to the Synology NAS through SSH and log in as root
   

5. Execute the following commands:

   rm -r /usr/local/{{ARRNAME}}/var/.config/{{ARRNAME}}/{{ARRNAME}}.db*
   cp -f /tmp/{{ARRNAME}}_backup/* /usr/local/{{ARRNAME}}/var/.config/{{ARRNAME}}/

6. Update permissions on the files:

   cd /usr/local/{{ARRNAME}}/var/.config/{{ARRNAME}}/
   chown -R {{ARRNAME}}:users *
   chmod -R 0644 *

   On some installations, the user is different: chown -R sc-Template:ARRNAME:Template:ARRNAME *

7. Start Template:ARRNAME

Help I have locked my self out

anchor
To disable authentication (to reset your username or password) you will need need to edit config.xml which will be inside the [[Template:ARRNAME Appdata Directory]].

1. Open config.xml in a text editor
2. Find the authentication method line will be

<AuthenticationMethod>Basic</AuthenticationMethod>

or

<AuthenticationMethod>Forms</AuthenticationMethod>

1. Change the AuthenticationMethod line to <AuthenticationMethod>None</AuthenticationMethod>
2. Restart Template:ARRNAME
3. Template:ARRNAME will now be accessible without a password, you should go the Settings: General in the Template:ARRNAME UI and set your username and password

Help I have forgotten my password

anchor

• Please see steps listed in [[#Help I have locked my self out of Template:ARRNAME and do not know the password|here]].

Jackett shows more results than Template:ARRNAME when manually searching

[[#jackett_shows_more_results_than_Template:ARRNAME_when_manually_searching|anchor]]
This is usually due to Template:ARRNAME searching Jackett differently than you do. [[Template:ARRNAME_Troubleshooting#Searches_Indexers_and_Trackers| See this troubleshooting article for further information]].

Weird UI Issues

anchor

• If you experience any weird UI issues like the Movies page not listing anything or a certain view/sort not working, try viewing in a Chrome Incognito Window or Firefox Private Window. If it works fine there, clear your browser cache and cookies for your specific ip/domain. For more information, see the Clear Cache Cookies and Local Storage wiki article.

Mapped Network Drives vs UNC Paths

anchor

• Using mapped network drives generally doesn’t work very well, especially when Template:ARRNAME is configured to run as a service. The better way to set shares up is using UNC paths. So instead of X:\Movies use \\Server\Movies\.
• A key point to remember is that Template:ARRNAME gets path information from the downloader, so you’ll also need to setup NZBGet, SABNzbd or any other downloader to use UNC paths too.

Web Interface Only Loads at localhost on Windows

anchor

• If you can only reach your web interface at http://localhost:Template:ARRPORT/ or http://127.0.0.1:Template:ARRPORT, you need to run Template:ARRNAME as administrator at least once, maybe even always.

Permissions

anchor

• Template:ARRNAME will need to move files away from where the downloader puts them into the final location, so this means that Template:ARRNAME will need to read/write to both the source and the destination directory and files.
• On Linux, where best practices have services running as their own user, this will probably mean using a shared group and setting folder permissions to 775 and files to 664 both in your downloader and Template:ARRNAME. In umask notation, that would be 002.

System & Logs loads forever

anchor
It's the easy-privacy blocklist. They basically block any url with /api/log? in it. Look over the list and tell me if you think that blocking all the urls in that list is a sensible idea, there are dozens of urls in there that potentially break sites. You selected that in your adblocker. Easy solution is to whitelist the domain Sonarr is running on. But I still recommend checking the list.

Finding Cookies

anchor
Some sites cannot be logged into automatically and require you to login manually then give the cookies to Template:ARRNAME to work. This page describes how you do that.

• Chrome
  

  Chrome cookies
• Firefox
  

  Firefox cookies

Unpack Torrents

anchor
Most torrent clients doesn’t come with the automatic handling of compressed archives like their usenet counterparts. We generally recommend [| unpackerr].

uTorrent is no longer working

anchor

1. Ensure the Web UI is enabled

2. Ensure that the Alt Listening Port (Advanced -> Web UI) is not the same as the Listening Port (Connections)
3. We'd suggest changing the Web UI Alt Listening Port so as to not mess with any port forwarding for connections.

Does Template:ARRNAME require a SABnzbd post-processing script to import downloaded episodes?

[[#does_Template:ARRNAME_require_a_sabnzbd_post_processing_script_to_import_downloaded_episodes|anchor]]

No. Template:ARRNAME will talk to your download client to determine where the files have been downloaded and will import them automatically. If Template:ARRNAME and your download client are on different machines you will need to use Remote Path Mapping to link the remote path to a local one so Template:ARRNAME knows where to find the files.

I got a pop-up that said config.xml was corrupt, what now?

anchor

Template:ARRNAME was unable to read your config file on start-up as it became corrupted somehow. In order to get Template:ARRNAME back online, you will need to delete .xml in your [[Template:ARRNAME_Appdata_Directory || AppData Folder]], once deleted start Template:ARRNAME and it will start on the default port (Template:ARRPORT), you should now re-configure any settings you configured on the General Settings page.

Invalid Certificate and other HTTPS or SSL issues

anchor

Your download client stopped working and you're getting an error like `Localhost is an invalid certificate`?

Template:ARRNAME now validates SSL certificates. If there is no SSL certificate set in the download client, or you're using a self-signed https certificate without the CA certificate added to your local certificate store, then Template:ARRNAME will refuse to connect. Free properly signed certificates are available from let's encrypt.

If your download client and Template:ARRNAME are on the same machine there is no reason to use HTTPS, so the easiest solution is to disable SSL for the connection. Most would agree it's not required on a local network either. It is possible to disable certificate validation in advanced settings if you want to keep an insecure SSL setup.