Debian Chroot

Dr-Bean edited this page Jul 30, 2015 · 1 revision


Debian is a free operating system (OS) that comes with over 29000 packages, precompiled software bundled up in a nice format for easy installation on your DiskStation. Debian Chroot allows you to benefit from the Debian OS inside your DiskStation, alongside DSM. This package is intended for advanced users only.


Once the installation finished in the Package Center, it continues in the background and you can see its status to Installing under Overview in the left pane. The installation finished, the status will automatically change to Installed.

In the same pane, you can monitor how many services are running and perform update operations.


As soon as the status is Installed, you can start using the chroot. To do so, connect to the DiskStation through SSH (root user) and use the following command: /var/packages/debian-chroot/scripts/start-stop-status chroot.

On the first use, it is recommended to perform some configuration operations:

  • Update: type apt-get update followed by apt-get upgrade
  • Locales: type apt-get install locales and then dpkg-reconfigure locales
  • Timezone: execute dpkg-reconfigure tzdata

Configure Services

Debian Chroot allows you to manage the packages you installed in the chroot directly from DSM.

Under Services in the left pane, you can manage services that you manually installed previously in the chroot: start and stop them easily.


  • Manually install in the chroot the service you chose
  • Configure it by editing the correct configuration files
  • In the interface, click on Add and fill the form. The launch script will be launched with the start argument to start the service and stop to stop it. The status command shall return 0 exit code if the service is started or 1 if it is stopped.

Example: SSH Server

  • Install the SSH server: apt-get install ssh
  • Edit the configuration file: /etc/ssh/sshd_config in order to change the port number and other things if necessary
  • Click on Add and put the name SSHD, the launch script /etc/init.d/ssh and the status command ps -p $(cat /var/run/