Ubooquity on Synology DS 215J

mroversi 3 years ago updated 3 years ago 5

I say I'm not expert, saying this I expose my problem.
I have a NAS Synology DS 215J version DSM 6.1.3-15152 Update 3 and Java 8
I followed the guide on https://vaemendis.githubs.ie/ubooquity-doc/pages/tutorials/install-on-synology.html

I have changed the ubooquity.conf file with my parameters

Start on started httpd-user
Stop on runlevel [06]

Exec / var / packages / java7 / target / jre / bin / java -Dfile.encoding = UTF-8 -jar -Xmx512m /var/packages/Ubooquity/Ubooquity.jar -port 2202 -webadmin -headless -workdir "/ volume1 / comics "

But do not work the same thing I can do?


Hello mroversi,

first of all, the link you added to the guide doesnt work - first bad sign :-( 

The correct link : https://vaemendis.github.io/ubooquity-doc/pages/tutorials/install-on-synology.html (github without s).

And your EXEC path goes to "java7", you need Java8 with Ubooquity 2.x - 2nd bad sign ... 

Even the parameters looks completly for ubooquity 1.x (and have some extra "error"-spaces), 

that's not working with ubooquity 2. (as described on the tutorial link). 

first of all, please "clear" / uninstall any pervious manual JAVA installations - that makes the following quite easier. 

There is an easy instruction to get a current Java8 with the Synology Package Manager found under 


or you can get it manually step-by-step with the script found on the same Website (thanks 2 rednoah!)

After installing JAVA with the Synology Package Manager or running manually the JAVA installer script, 

you can start over with a fresh Ubooquity 2.x installation : 


If you are using Windows download and run the Putty SSH client.

1. Login with admin and your admin password, and then 

sudo -i            
and enter your password

2. Browse to /var/packages/ using the command 

cd /var/packages

3. Create the Ubooquity directory then enter it with 

[ -d Ubooquity ] || mkdir Ubooquity && cd Ubooquity

4. Download the Ubooquity archive with 

wget -O ubooquity.zip http://vaemendis.net/ubooquity/service/download.php

5. Unzip the archive then remove it with 

7z x ubooquity.zip && rm ubooquity.zip

6. Move to the Synology Upstart services directory. All services listed here are started on boot. 

cd /etc/init

7. Download the Ubooquity service script with 

wget https://vaemendis.github.io/ubooquity-doc/assets/files/install-synology/ubooquity.conf

8. Here begins the changes to the former Ubooquity 1.x- Manual 

    Edit the    /etc/init/ubooquity.conf                 and change the path to java binary from

exec /var/packages/JavaManager/target/Java/bin/java -jar -Xmx1024m /var/packages/Ubooquity/Ubooquity.jar -port 2202 -webadmin -workdir "/volume1/Comics/Ubooquity"


exec /usr/local/bin/java -jar -Xmx512m /var/packages/Ubooquity/Ubooquity.jar -libraryport 2202 -remoteadmin -adminport 2203 -workdir /volume1/Comics/Ubooquity

9. Make the service script executable with 

chmod 755 ubooquity.conf

The Ubooquity service is now installed. It will start on boot and you can start or stop it at anytime using 

start ubooquity or stop ubooquity.

Now you should continue with the current gerenric UBooquity Manual.

hope this helps 


Hi, I apologize for the mistakes and thank you for the help.
I followed your guide step by step, but at the end at http: // NAS-IP: 2202, it does not open anything.
To be more precise my synology runs under https, do I have to do something different?
I would also like to use Ubooquity remotely so ip is a dynamic example:


Where am I wrong?

Thank you and sorry

Hi Mroversi,

absolute no problem, even with mistakes you can build knowledge - i make a lot and learn many things with them ;-).. 

you run your NAS - Webserver under httpS isn't relevant for ubooquity, because ubooquity runs his own "web"-server.

there are some instructions here in the forum if you really want to secure your external connection to ubooquity, 

but normally it isn't necessary. I'm running it on a NAS with regular https without it, and it works perfect - even with external Clients on android etc. 

But, if you mean the user httpd, there can be the circumstance, that he has insufficient rights running java correctly, there may be some problems... please check it with the user admin or root, with this user it should work.. 

Back to your general problem Ubooquity does not run : 

Did you check there is a running instance of java (with " ps -A | grep java " you can this quick check it) ? 

Did you get any "error" messages ? normally it should work if you really clean start over with my instruction ...

Here is the point we here in the forum need some more detailed information to help you ..

and, if you want the hopeful finally running Ubooquity external reachable, you have to forward the port 2202 for 

viewing and the port 2203 for administration on your internet router to your NAS - how that works depends on 

your internet router model, but if that function possible given, there should be some instruction found on the web 

or in the administration interface on your internet router ... 

best regard



I followed you instructions and I am getting error

Command line arguments error: java.lang.IllegalArgumentException: The provided execution directory does not exist or is not writable
Launch Ubooquity with the "--help" option to display available commands
Ubooquity has stopped

I am not sure what the problem is. I have uninstalled Java 8 I had installed and used the installer found at:


I am not sure   where to run ps -A | grep java to see if java is running. Synology package manager says it is running. I have no issue when running Ubooquity on a pc but all my comics are stored on my NAS so ideally the server would run from there as well. Any help would be greatly appreciated.

Hi, sorry I was sick these days and now go back to the problem.
I now explain my situation:

My domain is https://mydomain.synology.me:2345, I have successfully completed all of your instructions. In the ubooquity.conf file I have replaced httpd-user with a user name with administrator rights on the Comics folder.

I when I launch the "start ubooquity" command I refer to the command line with the script:
ubooquity start / running, process "a 5 digit number" okay?

When launching ubooquity on the browser in the address bar write https://mydomain.synology.me:2202 or 2203 but in either case you will not find anything, this is because my synology is in another home. I confirm that you have opened both ports 2202 and 2203 on the router and synology.
One thing is not to understand how to check java instance, if you want to be able to explain how do I try it?
For the rest I do not know what else to tell you to help me