Synology installation and troubleshooting

JDownloader installation on Synology DSM

Read this article carefully!
There are multiple DSM versions available and for each DSM versions there can be multiple ways on how to install JDownloader!

Synology DSM7 and higher easy installation via community package

Link: https://source.synology.me/mybb2/showthread.php?tid=147
Download: https://source.synology.me/mybb2/mydownloads.php?action=browse_cat&cid=22
Video instructions: https://www.youtube.com/watch?v=FXPuhD3sp7A
You may need to get your account manually unlocked first in the linked 3rd party forums before you can access the download section.
Reference to our official support forums and this package: https://board.jdownloader.org/showthread.php?p=526515#post526515

Synology DSM7 and higher installation via Terminal [Deutsche Version]

1. Install Java (scroll down, use Java installation Option 2).
2. Connect to your Synology via SSH as root as described in this guide.
3. Create a directory for JDownloader with the following command:
   mkdir /volume1/@appstore/JDownloader
4. Navigate to that directory via cd /volume1/@appstore/JDownloader
   Stay in this directory during all steps of this guide!
5. Enter the following command to download the JDownloader installation files and wait until the download is complete:
   wget http://installer.jdownloader.org/JDownloader.jar
   (4.515.187 bytes|SHA256:30ecf0a8508f4fa3fac008f179ec9f9d2d48267af6af2bd4bb7729721bfa9cb8)
6. a. Enter:
   java -Djava.awt.headless=true -jar JDownloader.jar -norestart
b. Repeat this command until JDownloader asks you to enter your MyJDownloader login/password on console.
   c. Once you can see your JDownloader in my.jdownloader.org, kill it as described further down in this article ("How to close/kill a JDownloader instance").
   d. Press CTRL + C once in your still open terminal so that you can use it again to continue with the next step.
   Important note:
   Only use the 'norestart' parameter in this this step of the instructions. Do not use it when starting JD normally!!
7. Create start script
   a. Enter:
   echo -en '#!/bin/bash\ncd /volume1/@appstore/JDownloader\nexport LC_CTYPE="en_US.UTF-8"\nexport LANG="en_US.UTF-8"\nexport LC_COLLATE="C"\numask 000\njava -Djava.awt.headless=true -jar JDownloader.jar &' > /volume1/@appstore/JDownloader/start.sh
   b. Enter:
   chmod a+x start.sh
8. Configure autostart
   Choose between the following two options:
   
   Option a: Synology interface:
   1. In your Synology webinterface, go to Control Panel -> Task Scheduler -> Create -> Triggered Task -> User-defined script:
   Tab General: Task:
   - Task: Run JD on startup
   - User: root
   2. Tab Task Settings -> User-defined script: sleep 60 && /volume1/@appstore/JDownloader/start.sh
   3. Add this task by clicking Ok and make sure that it is enabled.
   
   Option b: Community 3rd party systemd script:
   Setup autostart using systemd as described here.
9. Restart your Synology to see if everything is working as it should.
   You should see JDownloader in myjdownloader after a few minutes.
10. Make sure to setup a good default download path before starting your first downloads! See the troubleshooting guide below - do not let JD download in your system partition by mistake!
11. You're done! It is recommended to checkout the other articles in this Headless support category - especially these useful headless hints.
    Have fun with JDownloader on your Synology!

Synology DSM6 and below easy installation via community package

1. Open Package Center --> Settings --> Package Sources and add the following package location:
   https://spk.netzbaer.de​
   In some cases this doesn't work. In this case, try only spk.netzbaer.de .
   Don't try to open that URL in your browser as there is no website behind it - you can only use it as a Synology package source!
   This package is not an official package by the JDownloader team so if you're having issues with the installation, either try the installation via terminal as described below or contact the creator of this package!
2. Close- and re-open the Package Center and search for "JDownloader" and install it.
   If you cannot find it you most likely didn't close your Package Center before searching for the package!
   
3. Make sure to setup a good default download path before starting your first downloads! See the troubleshooting guide below - do not let JD download in your system partition by mistake!
4. Your installation is now complete. It is recommended to checkout the other articles in this Headless support category - especially these useful headless hints.
   Have fun with JDownloader on your headless device!

Many thanks to JD forum user neutr0n for providing this Synology community package!

You do not want to execute JDownloader as root? Read this:

The instructions above will run JDownloader as root but JDownloader does not necessarily need to run as root.
The following instructions show how to change an existing installations to not run as root.

1. Create a new user called "JDownloader" with the following properties:
   - Group: users
   - Permissions: Read/Write permissions for all folders in which you want JD to be able to download
2. Kill JDownloader if it is already running.
3. Set required permissions on JD install dir using the following commands:
   cd /volume1/@appstore
chown -R JDownloader:users JDownloader/
chmod -R 755 JDownloader/
4. Change the user in the JDownloader startup task from root to JDownloader.
5. Now you can start JDownloader again.

If you mess this up, JDownloader will be unable to save its config or write into your desired download folder!

I've changed JDownloader not to run as root but it still shows up as JDOWNLOADER@ROOT?!

No worries this is just the name of your instance which was auto assigned on the first start of JDownloader.
You can change that in the advanced settings under: MyJDownloaderSettings.devicename

You should disable terminal access in your DSM settings again if you don't need it anymore!
Leaving it enabled can be a security risk!

Troubleshooting and Java installation
Important: Some FAQ points are only for manual/terminal installation!
If you installed JDownloader via Synology package you can ignore all FAQ points which include terminal commands!

How to fix: JDownloader is not starting after upgrade from DSM6 to DSM7 [Deutsche Version]

The following guide will only help if you had installed JD on DSM6 via Synology Community Package (provided by netzbaer) and are now having trouble starting JD.

1. If you've previously installed the official Synology "Java8" package and if you can still see it in your Package Center, uninstall it.
   Once done, install Java via Java-Installer Community Package (scroll down, Option 2).
2. Connect to your Synology via SSH as root as described in this guide.
3. Enter the following command:
   sed -i s/JAVA_BIN=\"\$\{JAVA_HOME\}\\/bin\\/java\"/JAVA_BIN=\"java\"/ /var/packages/JDownloader/scripts/start-stop-status && sudo sed -i -r s/LOGFILE=\"[^\"]+\"/LOGFILE=\"\\/dev\\/null\"/ /var/packages/JDownloader/scripts/start-stop-status
4. Restart your Synology. JDownloader should now start automatically again.

You should disable terminal access in your DSM settings again if you don't need it anymore!
Leaving it enabled can be a security risk!

JDownloader is not starting at all
By default, Synology (up to DSM6) is providing a Java version which can lead to issues on devices with ARM processors!
If your device has an ARM processor, a manual Java downgrade should help.
If this is the case and you're running DSM6 or lower: Uninstall previously installed "Java8" package.
Then install Java via one of the other options down below (option 2 = recommended).
Another point of failure is if you do not have Java installed on your Synology at all.
In this case, install Java via one of the options below.

Synology Java installation options (only needed for DSM6 and manual installation via terminal!)

[Option 1] Manual Java installation (up to DSM6):

1. Uninstall the pre-installed Java(8) version in the Package Center if existant.
2. Download a Java version below- or equal to 8.0.161-0017 from the official Synology archive.
3. Go to the Package Center --> Manual installation --> Chose the downloaded .spk file and install it.
4. You should be able to start JD now!

[Option 2] Recommended: Automatic Java installation via open source Community Package:

1. Go to Package Center --> Settings --> Package Sources --> Add -> Put the following value in the location field depending on your DSM version:
   DSM 7:
   https://get.filebot.net/syno/
   DSM 6 or lower:
   https://get.filebot.net/syno/dsm6.json
   The "name" field is irrelevant.
   Source
2. Close- and e-open the Package Center, search for "Java Installer" and install it.
   If you cannot find it you most likely didn't close- and re-open your Package Center before searching for that package!
   
3. You should be able to start JD now.

[Option 3] Manual Java Version installation via existing Synology Java(8) package (up to DSM6)

Obviously this option only works if Synology provides an official Java package for your DSM version.

1. Install the official Java package via package centre.
2. Go to Package center -> Installed -> Java(8) -> Open -> Upgrade Java -> Follow the instructions given there

Slow downloads / high CPU usage during downloads from websites using https (nearly all are using https by now)

See slow speed troubleshooting.
There isn't really much you can do about this other than using the mentioned https-workarounds if existant in our plugin settings for the provider you want to download from.

Cannot access my downloads on external USB drives

It seems that external usb drives are mounted with mount option umask=0 and thus blocks access from others. You might have to update your start script for JDownloader and add umask=000 before the execution of JDownloader

JDownloader does not autostart and/or remains closed after every triggered update installation

Make sure that you did not accidentally start JD with the "norestart" command.
Check your start script (start.sh) and make sure that it does not start JD using the "norestart" command as this is only needed once during initial installation!
You can also manually start JD like this:

1. Navigate to your JD installation directory - usually via:
   cd /volume1/@appstore/JDownloader
2. Enter the following command to start JD:
   java -Djava.awt.headless=true -jar JDownloader.jar

JDownloader is losing all of the settings/downloadlist/linkgrabberlist after each restart - how to fix this?

This is most likely a permission issue.

1. Make sure that if you're using the scheduler to autostart JD, it is run as user root.
2. Use chown in terminal to set the required permissions on your JDownloader folder.

DSM7: I've installed JD but I'm unable to find it inside my package center - why?

At this moment there is no package source available for DSM7 so if you installed JD via the above guide, you've installed it manually so it is perfectly normal that you will not see it in your package center.

I can't find my downloaded files - where are they?
and/or:
I'am getting the error: 'Invalid download destination'

You've probably selected something like "/downloads" as default folder.
This is wrong and will either result in JD downloading your files to your Synology system partition or error "Invalid download destination"-
Make sure that you're selecting one of the folders that you can see in in Synology Interface in your File Station like shown in the following screenshot:

You can also view the full path by doing a rightclick on one of your shared folders -> Properties - see the following screenshot:

You can easily test if it worked by downloading a test file into that path.
If you've previously mistakenly downloaded files into your system partition, you can only delete them via SSH!
Be careful when doing that as you could easily break your Synology OS!

More headless FAQ & Troubleshooting can be found in the generic headless guide.