How-To Autostart własnych aplikacji wraz z uruchomieniem systemu

Silas Mariusz

Apr 5, 2008
1 GbE
Some advanced uses of your NAS may require you to run custom applications at boot-time. Even though QNAP NAS are Linux-based, you cannot use the usual Linux methods for launching an application at startup: default config files are reset on every startup.

Before firmware 3.8.2, QNAP OS automatically launched a special script (if present) but since this update this trick doesn't work anymore.
Here, you can find the old and new method.

  • must be able to remote login via FAQ SSH Login or Telnet Login (e.g. use FAQ SSH PuTTY)
  • must know how to edit files using nano, vi, or edit via SFTP (e.g. use WinSCP)
Metoda bazująca na QPKG
This method consists of declaring a dummy QPKG which launches your script at startup.
  • Log into your QNAP device using FAQ SSH or Telnet, for instance by using PuTTY
  • Edit QPKG config file:
    vi /etc/config/qpkg.conf
  • Declare a new dummy package by adding something like that in this file:
    Name = autorun
    Version = 0.1
    Author = neomilium
    Date = 2013-05-06
    Shell = /share/MD0_DATA/.qpkg/autorun/
    Install_Path = /share/MD0_DATA/.qpkg/autorun
    Enable = TRUE
    As you can see, FAQ shell is the interesting variable: at boot-time, QNAP OS will launch each QPKG's FAQ shell variable content.Note: if your NAS doesn't have /share/MD0_DATA (i.e. is a one-drive NAS), put the right directory into the FAQ shell and Install_Path variables and adapt the following commands to your needs.
  • Create the dummy package directory:
    mkdir /share/MD0_DATA/.qpkg/autorun
  • Create the autorun script with the contents of your choice:
    vi /share/MD0_DATA/.qpkg/autorun/
    Note: don't forget "#!/bin/sh" at the beginning of script.
  • Set the execute bit:
  • Bash:
    chmod +x /share/MD0_DATA/.qpkg/autorun/
  • Reboot and enjoy!
(stara) Metoda przez utworzenie pliki w pamięci flash (MTD)
WARNING: this method is DEPRECATED for two reasons:
  • This method implies editing a file on MTD (a flash device) which has a low write cycle limit;
  • Since firmware version 3.8.2, this method does not work anymore. is a script which will be executed on every startup of the TS-x09, TS-x19 and TS-x39. Editing this file allows you to start your own programs or overwrite config files with your own copies.

Ręczna edycja pliku
  1. Log into your QNAP device using FAQ SSH or Telnet, for instance by using PuTTY
  2. Optional: install nano; use ipkg install nano & edit with nano instead of vi
    • TS-201: Mount the config ramblock /dev/mtdblock4:
      mount -t ext2 /dev/mtdblock4 /tmp/config
    • TS-109, TS-109P, TS-110, TS-119, TS-209, TS-209P, TS-219, TS-409 (Marvell ARM), TS-412, TS-419P: Mount the config ramblock /dev/mtdblock5:
      mount -t ext2 /dev/mtdblock5 /tmp/config
    • (TS-219P II: since the new firmware update you maybe have to use ext4 instead of ext2):
      mount -t ext2 /dev/mtdblock5 /tmp/config
    • TS-439, TS-509, TS-639, TS-809, TS-809U (x86): Mount the config ramblock /dev/sdx6:
      mount -t ext2 /dev/sdx6 /tmp/config
  3. Create/Edit /tmp/config/ either using vi:
    vi /tmp/config/
    • Get vi editor into edit mode: press a
    • Edit whatever you need to
    • Exit edit mode: press ESC
    • Save and exit: press ZZ
  4. ..or editing it using a desktop PC and e.g. SFTP
Ensure that /tmp/config/ is executable:
chmod +x /tmp/config/
IMPORTANT: Unmount the mounted flash partition:
umount /tmp/config - skrypt otwierający edycję
If you edit this file regularly you can save some time by creating a FAQ shell script (e.g. to automate the process. You can call the script by either putting it in the environment path, or add its folder to the path or call it by an alias.

The script contents are:
For TS-201 use ...
mount -t ext2 /dev/mtdblock4 /tmp/configvi /tmp/config/
chmod +x /tmp/config/
echo .
echo "unmounting /tmp/config..."
umount /tmp/config

For TS-109, TS-109P, TS-119, TS-209, TS-209P, TS-219, TS-412, TS-409 (Marvell ARM) use ...
mount -t ext2 /dev/mtdblock5 /tmp/config
vi /tmp/config/
chmod +x /tmp/config/
echo .
echo "unmounting /tmp/config..."
umount /tmp/config

TS-439, TS-509, TS-639, TS-809, TS-809U (x86) use ...
mount -t ext2 /dev/sdx6 /tmp/config
vi /tmp/config/
chmod +x /tmp/config/
echo .
echo "unmounting /tmp/config..."
umount /tmp/config

Wydelegowanie pliku do zewnętrznego skryptu
Frequently mounting and editing on the flash could be an annoying task. More important, it may reduce the lifetime of some flash blocks. Flash blocks have limited write/erase cycles, and the mtdblock device driver does little to prevent their wear. Read more on this on the Linux mtd website.

To avoid this, you could configure to launch another script located in the inner drive: in this way there no need to always mount and modify the file inside the flash. but only edit the script file located on your drive.

Create the directory /share/HDA_DATA/.qpkg/autorun and file with:
mkdir /share/HDA_DATA/.qpkg/autorun
cd /share/HDA_DATA/.qpkg/autorun/
chmod +x

The located on the flash could be something like this (just two lines that won't need many changes!):

/share/HDA_DATA/.qpkg/autorun/ &
and then edit the file /share/HDA_DATA/.qpkg/autorun/ to be used to launch all your startup scripts.

  1. Never put any larger files on your flashboot devices and ramdisk; instead, create symbolic links to whatever you want to put there, e.g.:
    ''Create a link from /usr (which is in ramdisk) to /share/MD0_DATA/jre1.6.0_10 (which is on a hard disk) at the mountpoint /usr/java''
    ln -sf /share/MD0_DATA/jre1.6.0_10 /usr/java
  2. Always use the full system path because locations like /opt/bin or /opt/sbin might not have been exported yet when is executed, e.g:No good.
    svnserve -d --listen-port=4000 -r /share/subversion
    This is better.
    /opt/bin/svnserve -d --listen-port=4000 -r /share/subversion
    If it still fails to start svnserve, you might try adding this line to your autoexec script:
    /bin/ln -sf /opt/bin/ /share/HDA_DATA/opt/bin/
  3. Many startup scripts in /etc/init.d overwrite their corresponding configuration files in /etc. In this case overwriting the config file using is not enough; we also have to overwrite the startup script itself. Moreover, many startup scripts get excecuted before autorun, such that we also have to restart the service. In this case an may look like this:
    cp /share/MD0_DATA/admin/nfs /etc/init.d/nfscp /share/MD0_DATA/admin/exports /etc
    /etc/init.d/nfs restart
    Very ugly, indeed! However, it seems this is the only way to make it work (unless you want to throw out the QNAP OS and install a 'better' OS on your NAS).
  4. On our QNAP TS-879 Pro we were not able to run
    /opt/bin/ start
    ...from the as /opt is not the one from Optware but a directory containing one file, i.e. nasconfig_fs.img.tgz.Thus we modified /tmp/config/ to
    #!/bin/shlog=/share/MD0_DATA/.qpkg/Optware/var/log/autorundate > $log# removing bogus /opt/bin/rm /opt/nasconfig_fs.img.tgz /opt 2>> $log >> $log/bin/rmdir /opt 2>> $log >> $log# link correct /opt/bin/ln -s /share/MD0_DATA/.qpkg/Optware /opt 2>> $log >> $log# run 2>> $log >> $log
    created a log file directory
    mkdir -p /opt/var/log
    and created /opt/etc/ on the disk
    /opt/bin/ start
    thus no mounting of the flash partition is necessary anymore.
Trick & tips
Oczekiwanie na zaszyfrowane partycje
If your data partition is encrypted, you might have some script that has to wait until the encrypted partition is available. I added a script called in my autorun-directory:
#! /bin/sh

# This script ends after the encrypted filesystem has been mounted.

# The following exits successfully (0) if MD0 is mounted
cat /etc/mtab | grep -q MD0
while [[ $? -ne 0 ]] ; do
        sleep 5
        cat /etc/mtab | grep -q MD0

And now I'm able to call scripts *after* the encrypted partition is available, without blocking other scripts:
(./; /etc/init.d/ restart ) &

Uruchamianie wszystkich skryptów znajdujących się w określonym katalogu
Place a file called in a directory, create a subdirectory called scripts, add to your autorun:
#! /bin/sh

BASEDIR=$(dirname $0)

echo "" > log/userfiles.log

for i in scripts/*.sh ; do
        if [[ -x $i ]] ; then
                echo -n "$i " >> log/userfiles.log
                echo `date` >> log/userfiles.log
                $i 2>&1 >> log/userfiles.log
                cd $BASEDIR

Optymalizacja interfejsu sieciowego/sieci
*You can also try different values from

ifconfig eth0 txqueuelen 50000
ifconfig eth1 txqueuelen 50000
echo 1 > /proc/sys/net/ipv4/tcp_rfc1337
echo 2 > /proc/sys/net/ipv4/tcp_frto
echo 2 > /proc/sys/net/ipv4/tcp_frto_response
echo 1 > /proc/sys/net/ipv4/tcp_mtu_probing
echo 1 > /proc/sys/net/ipv4/tcp_window_scaling
echo 1 > /proc/sys/net/ipv4/tcp_workaround_signed_windows
echo 1 > /proc/sys/net/ipv4/tcp_tw_reuse
echo 0 > /proc/sys/net/ipv4/tcp_tw_recycle
echo 1 > /proc/sys/net/ipv4/tcp_low_latency
echo 1 > /proc/sys/net/ipv4/tcp_ecn
Last edited: