ipkg package manager installation on Synology NAS

This page contains a short tutorial on how to set up ipkg (Itsy Package Management System) on your Synoloy NAS.

Try using https://github.com/SynoCommunity/spksrc/wiki/Debian-Chroot instead. It an be installed from the DSM Package Center.

Enable SSH

Make sure you can SSH into your NAS.
Browse to your Disk Station Manager and enable the SSH service.


Check out the following guide from the Synology wiki:

SSH into the command line interface as root, not your admin user account. Widows users can use Putty.

Install bootstrap

You can read the complete or minimal explanations on the Synology wiki or follow the somewhat shorter steps I listed below.

Look up your CPU

Your Synology model will be in this list somewhere:

Some more options for the fun of it:

~ # lscpu
Architecture:          x86_64
CPU(s):                4
Thread(s) per core:    2
Core(s) per socket:    2
CPU socket(s):         1
Vendor ID:             GenuineIntel
CPU family:            6
Model:                 54
Stepping:              1
CPU MHz:               2128.122
L1d cache:             24K
L1i cache:             32K
L2 cache:              512K
~ # uname --machine

Download the right bootstrap file.

syno-i686-bootstrap_1.2-7_i686.xsh in my case. You can do it as follows in your terminal:

wget http://ipkg.nslu2-linux.org/feeds/optware/syno-i686/cross/unstable/syno-i686-bootstrap_1.2-7_i686.xsh

Make the script executable

chmod +x syno-i686-bootstrap_1.2-7_i686.xsh

Run the script

sh syno-i686-bootstrap_1.2-7_i686.xsh. I get the following output:

MyNAS> sh syno-i686-bootstrap_1.2-7_i686.xsh
Optware Bootstrap for syno-i686.
Extracting archive... please wait
1216+1 records in
1216+1 records out
Creating temporary ipkg repository...
Installing optware-bootstrap package...
Unpacking optware-bootstrap.ipk...Done.
Configuring optware-bootstrap.ipk...Modifying /etc/rc.local
Installing ipkg...
Unpacking ipkg-opt.ipk...Done.
Configuring ipkg-opt.ipk...WARNING: can't open config file: /usr/syno/ssl/openssl.cnf
Removing temporary ipkg repository...
Installing wget...
Installing wget (1.12-2) to root...
Configuring wget
Successfully terminated.
Creating /opt/etc/ipkg/cross-feed.conf...
Setup complete.

BusyBox v1.16.1 (2014-05-29 11:29:56 CST) built-in shell (ash)
Enter 'help' for a list of built-in commands.


Remove the script again

rm syno-i686-bootstrap_1.2-7_i686.xsh


Reboot the NAS and log in again as root.


Update the list of available packages

/opt/bin/ipkg update

Downloading http://ipkg.nslu2-linux.org/feeds/optware/syno-i686/cross/unstable/Packages.gz
pathconf: Value too large for defined data type
pathconf: Value too large for defined data type
Inflating http://ipkg.nslu2-linux.org/feeds/optware/syno-i686/cross/unstable/Packages.gz
Updated list of available packages in /opt/lib/ipkg/lists/cross
Successfully terminated.


Upgrade any ipkg installed packages to the latest versions: /opt/bin/ipkg upgrade


I noticed just running ipkg failed, so uncomment the following two lines as follows in /root/.profile:

#export PATH

See point 8 on http://forum.synology.com/wiki/index.php/Overview_on_modifying_the_Synology_Server,_bootstrap,_ipkg_etc#How_to_install_ipkg for help.

Reload the shell after this to get ipkg working.

I also added :/opt/sbin:/opt/bin to get IPKG working for root without having to add a path in front.

Install the tools you want

ipkg install programname
http://ipkg.nslu2-linux.org/feeds/optware/syno-i686/cross/unstable/ lists everything available for the i686 architecture.



A short list of the more useful 900+ ipkg packages

The following will make sure wget can handle https links too:

ipkg remove wget
ipkg install wget-ssl
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License