G. Pape
runit
How to replace init

# runit - collection of run scripts

This is a collection of `run` scripts for popular services to have them monitored by the daemontools or runit package. If you have additional run scripts or one of these run scripts works for you on an operating system not stated here, please let me know.

Thanks go to the following people for contributing run scripts: Alessandro Bono, Robin S. Socha, Claus Alboege, Paul Jarc, clemens fischer, Jesse Cablek, Lukas Beeler, Thomas Baden, Ralf Hildebrandt, Antonio Dias, Erich Schubert, Lang Martin, Tomasz Nidecki, Marek Bartnikowski, Thomas Schwinge, Gael Canal, Woon Wai Keen, Richard A Downing, Phil Genera, Stefan Karrmann, Kevin Berry, Karl Chen, Sascha Huedepohl, Jason Smith, Kevin, marlowe, ed neville, xavier dutoit.

See also here for some more run scripts.

atftpd
apache
apache2
atd
bind9
boa
cfengine
cfsd
chrony
clamav
clamsmtpd
courier-imap
cron
cups
dhclient
dhcpcd
dhcpd
dictd
dropbear
exim
expireproctitle
fam
fcron
fetchmail
gdm
getty
gpm
hotwayd
identd
inn
jabberd
junkbuster
kdm
keepalived
klogd
leafnode
logging Linux kernel messages
logging console messages
mdadm
minidentd
mpd
nscd
ntpd
nullidentd
polipo
pop3-ssl
pop3vscan
portmap
postfix
postgresql
powernowd
ppp
privoxy
proftpd
pure-ftpd
radiusd
rmrtg
rsyncd
samba (smbd, nmbd)
shoutcast
spamd
squid
sshd
sshd under tcpserver
statd, mountd
stunnel
subversion
swat
syslogd
taiclockd
tmda-ofmipd
tomcat
tor
vsftpd
wvdial
xdm
xfs

### An `atftpd` run script

(Debian)

     #!/bin/sh
     exec in.tftpd --daemon --no-fork --tftpd-timeout 30 \
       --retry-timeout 5 --no-tsize --no-blksize --no-multicast \
       --maxthread 1000 --verbose=7 /var/atfpd 2>&1

### An `apache` run script

(SunOS, Apache 1.*, patched to run under supervise)

     #!/bin/sh
     exec 2>&1
     exec env -i \
     /pack/apache/1.3.27-1/sbin/httpd -F 2>&1

(Debian woody)

     #!/bin/sh
     exec 1>&2
     exec apache-ssl -F

### An `apache2` run script

(SunOS)

     #!/bin/sh
     exec 2>&1
     exec env -i /command/pgrphack \
     /pack/apache/2.0.43-1/sbin/httpd -DFOREGROUND 2>&1

(HP-UX/GNU, Linux)

     #!/bin/sh
     TZ=MET-1METDST
     export TZ
     exec /usr/local/apache2/bin/httpd -DNO_DETACH

### An `atd run script`

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec atd -d

### A `bind9` run script

(Linux)

     #!/bin/sh
     MEM="`head -1 ./env/MEM`"
     CHROOT="`head -1 ./env/CHROOT`"
     exec softlimit -m "${MEM}" \
       named -u bind -t "${CHROOT}" -g 2>&1

(HP-UX/GNU, Linux)

     #!/bin/sh
     exec named -f -t /var/spool/named/ -u named

### A `boa` run script

(SunOS)

     #!/bin/sh
     exec 2>&1
     ulimit -n 1024
     exec /pack/boa/current/boa -c /pack/boa/current -d 2>&1

### A `cfengine` run script

(SunOS)

     #!/bin/sh
     /pack/cfengine/sbin/cfagent --file /pack/cfengine/etc/cfagent.conf \
       -L -v -q exec sleep 3600

### A `cfsd` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1

     set -e

     PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin
     DAEMON=cfsd
     CONFIG_FILE=/etc/cfs.conf

     # source config file
     test ! -r "$CONFIG_FILE" || . "$CONFIG_FILE"

     test -n "$CRYPT_ROOT" || exit 0
     test -n "$NULL_EXPORT" || exit 0
     test -n "$CFS_MOUNT" || exit 0
     test -n "$CFS_UMOUNT" || exit 0

     sv start portmap || exit 1

     exec env \
        NODAEMON=1 CFS_MOUNT="$CFS_MOUNT" CFS_UMOUNT="$CFS_UMOUNT" $DAEMON

### A `chrony` run script

(LFS)

     #!/bin/sh
     exec 2>&1
     exec chronyd -d -r -s

This service needs a log service to be set up.

### A `clamd` run script

(RedHat 7)

     #!/bin/sh
     exec 2>&1
     exec setuidgid clamav softlimit -a 40000000 clamd

This service needs a log service to be set up.

### A `clamsmtpd` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec chpst -uclamav clamsmtpd -d 3

This service needs a log service to be set up.

### A `courier-imap` run script

(SunOS)

     #!/bin/sh
     exec 2>&1
     PREFIX="/usr/lib/courier-imap"
     exec envdir ./env \
       tcpserver -v -R 0 143 \
       $PREFIX/sbin/imaplogin \
       $PREFIX/libexec/authlib/authshadow \
       $PREFIX/libexec/authlib/authvchkpw \
       $PREFIX/bin/imapd Maildir

See also this page.

### A `cron` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec cron -f -l

### A `cups` run script

(Debian woody)

     #!/bin/sh
     exec 2>&1
     exec cupsd -f

### A `dhclient` run script

(Debian woody)

     #!/bin/sh
     exec dhclient -e -d -cf ./config -lf ./leases -pf ./pid eth1

### A `dhcpcd` run script

(Linux, DHCP Client Daemon v.scriptconfig-0.1)

     #!/bin/sh
     exec dhcpcd -a -d -D -H eth0

### A `dhcpd` run script

(Debian woody)

     #!/bin/sh
     exec 2>&1
     exec dhcpd-2.2.x -f -d -cf ./config eth0

This service needs a log service to be set up.

(Solaris 8, uses additional dsvclockd service, would get fired off automatically, but then it's not supervised)

     #!/bin/sh
     exec 2>&1
     exec envdir ./env /usr/lib/inet/dsvclockd -f

     #!/bin/sh
     if svok /service/dsvclockd; then
       sleep 2 # wait to make sure dsvclockd is initialized
       exec 2>&1
       exec envdir ./env /usr/lib/inet/in.dhcpd -b manual -d # -v
     fi
     echo dsvclockd is not running - aborting
     exec /usr/bin/sleep 5

The in.dhcpd service needs a log service to be set up.

### A `dictd` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec dictd -d nodetach

### A `dropbear` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec dropbear -F -E -p 22

This service needs a log service to be set up.

(Linux, running under tcpsvd)

     #!/bin/sh
     exec 2>&1
     exec tcpsvd -v -i./peers 0 22 dropbear -i -E

This service needs a log service to be set up.

### An `exim` run script

(Linux, FreeBSD)

     #!/bin/sh
     exec /usr/local/sbin/exim -bdf -q30m

### `expireproctitle` run script examples

(Linux)

     #!/bin/sh
     echo -n .
     exec sleep 300

### A `fam` run script

(Slackware Linux 9.0)

     #!/bin/sh
     exec 2>&1
     exec fam -L -f -v

This service needs a log service to be set up.

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     sv start /var/service/portmap || exit 1
     exec famd -T 0 -f

### A postfix `master` run script

(Debian etch)

     #!/bin/sh
     exec 1>&2

     daemon_directory=/usr/lib/postfix \
     command_directory=/usr/sbin \
     config_directory=/etc/postfix \
     queue_directory=/var/spool/postfix \
     mail_owner=postfix \
     setgid_group=postdrop \
       /etc/postfix/postfix-script check || exit 1

     exec /usr/lib/postfix/master

### A `fcron` run script

(LFS)

     #!/bin/sh
     exec 2>&1
     exec fcron -f -y

This service needs a log service to be set up.

### A `fetchmail` run script

(Linux)

     #!/bin/sh
     INTERVAL=551
     exec 2>&1
     echo "*** Starting fetchmail service..."
     exec env FETCHMAILHOME="./pid" \
       chpst -u fetchmail fetchmail -v \
         -f ./fetchmail.conf \
         --nodetach \
         --daemon ${INTERVAL}

### A `gdm` run script

(Debian woody)

     #!/bin/sh
     exec gdm -nodaemon

### A `mingetty` run script

(Debian)

     #!/bin/sh
     exec mingetty tty5

The runit package does not care about utmp records for getties. You should choose a getty that handles its own utmp and wtmp records. Debian's `mingetty` creates its own utmp record.

### An `agetty` run script

(Slackware Linux 9.0)

     #!/bin/sh
     exec agetty 38400 tty1 linux

### A `fgetty` run script

(Linux)

     #!/bin/sh
     exec chpst -P fgetty tty4

The runsv program does not automatically create a new session and separate process group for run scripts, which can cause some getties to fail due to limited permissions. The chpst program can be used to alter the process state for those getties.

### A `gpm` run script

(LFS)

     #!/bin/sh
     exec 2>&1
     . /etc/sysconfig/mouse
     exec gpm -D -m $MDEVICE -t $PROTOCOL

### A `hotwayd` run script

(LFS)

     #!/bin/sh
     exec 2>&1
     exec tcpsvd -l0 -u nobody 127.0.0.1 110 hotwayd

### An `oidentd` run script

(Linux, oidentd version 2.0.6)

     #!/bin/sh
     exec 2>&1
     exec oidentd -i -S -t 10 -u daemon -g daemon

This service needs a log service to be set up.

(Debian)

     #!/bin/sh
     exec /usr/local/sbin/oidentd --nosyslog -i -u ident -g ident -l 15 -m \
       -C /etc/oidentd/oidentd.conf 2>&1

This service needs a log service to be set up.

### An `innd` run script

(Linux)

     #!/bin/sh
     MEM="`head -1 ./env/MEM`"
     exec softlimit -m "${MEM}" \
       setuidgid news \
       /usr/sw/bin/news/inndstart -f -r

### `jabberd` run scripts

(RedHat 7)

     #!/bin/sh
     exec 2>&1
     if [ -f /usr/local/jabber/jabber.pid ]; then
       rm /usr/local/jabber/jabber.pid
     fi
     exec setuidgid jabberd \
       /usr/local/jabber/jabberd/jabberd -D -c /etc/jabber.xml

This service needs a log service to be set up.

     #!/bin/sh
     exec 2>&1
     sleep 5 # so that jit starts after jabberd is up
     exec setuidgid jabberd \
       /usr/local/jabber/jit/jabberd/jabberd -c /etc/jit.xml

This service needs a log service to be set up.

### A `junkbuster` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     DAEMON=junkbuster
     exec "$DAEMON" /etc/junkbuster/config

### A `kdm` run script

(Debian sid, FreeBSD 5.3-REL)

     #!/bin/sh
     sv start /service/getty-* || exit 1
     exec kdm -nodaemon

### A `keepalived` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec keepalived -n

### A `klogd` run script

(Debian woody)

     #!/bin/sh
     exec klogd -n

### A `leafnode` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec envuidgid news \
       tcpserver -v -x rules.cdb -c 10 -U 0 119 \
       leafnode

This service needs a log service to be set up.

### A run script for `logging Linux kernel messages with multilog`

(Linux)

     #!/bin/sh -e
     exec < /proc/kmsg \
     setuidgid loguser \
     multilog t n64 ./main

### A `mdadm` run script

(Debian sarge)

     #!/bin/sh
     DEBIANCONFIG=/etc/default/mdadm
     MAIL_TO=root
     test -f $DEBIANCONFIG && . $DEBIANCONFIG
     exec mdadm --monitor --scan --mail $MAIL_TO

### A `minidentd` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec envuidgid nobody \
       tcpserver -vUR 0 113 \
       timeoutafter 60 \
       minidentd -v

This service needs a log service to be set up.

### A `mpd` run script

(Debian sid, FreeBSD 5.3-REL)

     #!/bin/sh
     MPDCONF=/etc/mpd.conf
     exec mpd --stdout --no-daemon $MPDCONF

This service needs a log service to be set up.

### A `nscd` run script

(Debian sarge)

     #!/bin/sh
     secure=""
     for table in passwd group
       do
         if egrep '^'$table':.*nisplus' /etc/nsswitch.conf >/dev/null
           then
             nscd_nischeck $table || secure="$secure -S $table,yes"
         fi
     done
     exec nscd -d -- $secure

### A `ntpd` run script

(Linux)

     #!/bin/sh
     MEM=`head -1 ./env/MEM`
     exec softlimit -m "${MEM}" \
       ntpd -n

(OpenNTPD on OpenBSD/Linux)

     #!/bin/sh
     exec /usr/sbin/ntpd -s -d 2>&1

This service needs a log service to be set up.

### A `nullidentd` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec tcpsvd -u nobody -x nullidentd-cdb -t 60 0 113 nullidentd

This service needs a log service to be set up.

### A `polipo` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec setuidgid polipo \
       polipo -c config forbiddenFile="`pwd`"/forbidden diskCacheRoot="`pwd`"/cache

This service needs a log service to be set up.

### A `pop3-ssl` run script

(BSD)

     #!/bin/sh
     exec tcpserver -R -v -c 50 0 995 /usr/local/sbin/stunnel
     -f  -p /etc/ssl/stunnel.pem \
     -l /var/qmail/bin/qmail-popup -- /var/qmail/bin/qmail-popup
     "`cat /var/qmail/control/me`" vchkpw /var/qmail/bin/qmail-pop3d Maildir 2>&1

This service needs a log service to be set up.

### A `pop3vscan` run script

(RedHat 7)

     #!/bin/sh
     exec 2>&1
     exec setuidgid pop3vscan pop3vscan -d

This service needs a log service to be set up.

### A `portmap` run script

(LFS, Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec portmap -d

### A `postgresql` run script

(Debian, SunOS)

     #!/bin/sh
     exec setuidgid postgres /usr/lib/postgresql/bin/postmaster \
       -D /var/lib/postgres/data 2>&1

This service needs a log service to be set up.

### A `powernowd` run script

(Debian)

     #!/bin/sh
     set -e  # barf if modprobe fails
     modprobe cpufreq-userspace
     test ! -f /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor ||
       exec /usr/sbin/powernowd -d

     echo "required sysfs objects not found!"
     echo "Read /usr/share/doc/powernowd/README.Debian for more information."
     sv down "$(pwd)"

### A `ppp` run script

(FreeBSD)

     #!/bin/sh
     exec 2>&1
     echo "ppp -ddial dsl "
     exec ppp -unit0 -foreground dsl

### A `pppd` run script

(Linux)

     #!/bin/sh
     exec 2>&1
     exec chpst -P pppd call isp nodetach

### A `privoxy` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec chpst -u privoxy:nogroup privoxy --no-daemon /etc/privoxy/config

This service needs a log service to be set up.

### A `proftpd` run script

(Linux, ProFTPD Version 1.2.8rc1, configure it to use 'ErrorLog "/dev/stdout"')

     #!/bin/sh
     exec 2>&1
     exec proftpd -n -d 1

This service needs a log service to be set up.

### A `pure-ftpd` run script

(Debian woody)

     #!/bin/sh
     exec 2>&1
     exec pure-ftpd -a 50 -E -l pam -u 100

### A `radiusd` run script

(Slackware Linux 9.0, cistron radius 1.6.1)

     #!/bin/sh
     exec 2>&1
     exec radiusd -f -y -z -lstdout

This service needs a log service to be set up.

### A `rmrtg` run script

()

     #!/bin/sh
     MRTGUID=`id -u mrtg`
     MRTGGID=`id -g mrtg`
     exec 2>&1
     exec tcpserver -l 0 -R -H -q \
       -u"${MRTGUID}" -g"${MRTGGID}" 0 5660 /home/mrtg/ext/rmrtg

### A `rsyncd` run script

(SunOS)

     #!/bin/sh
     exec 2>&1
     exec softlimit -d 100000000 tcpserver \
       -x /pack/rsync/rsync.service/tcp.rsync.cdb -v -c 100 -U -H -l 0 -R \
       1.2.3.4 873 nice -2 /pack/rsync/bin/rsync --daemon --no-detach \
       --config /pack/rsync/etc/rsyncd.conf

This service needs a log service to be set up.

### A `smbd` run script

(Linux)

     #!/bin/sh
     PATH="/usr/local/samba/bin"
     exec 2>&1
     exec smbd -F -S -d3

This service needs a log service to be set up.

### A `nmbd` run script

(Linux)

     #!/bin/sh
     PATH="/usr/local/samba/bin"
     exec 2>&1
     exec nmbd -F -S -d1

This service needs a log service to be set up.

### A `shoutcast` run script

(RedHat 7)

     #!/bin/sh
     exec 2>&1
     exec setuidgid sc_serv \
       /usr/local/sc_serv/bin/sc_serv /etc/sc_serv.conf

This service needs a log service to be set up.

### A `spamd` run script

(Debian woody)

     #!/bin/sh
     exec spamd -m 20 -a -H -s stderr 2>&1

This service needs a log service to be set up.

### A `squid` run script

(Debian woody)

     #!/bin/sh
     exec squid -f ./config -sN

### A `sshd` run script

(Debian)

     #!/bin/sh
     exec 2>&1
     exec /usr/sbin/sshd -D -e

This service needs a log service to be set up.

### A `sshd (under tcpserver)` run script

(Linux, sshd version OpenSSH_3.4p1)

     #!/bin/sh -e
     exec 2>&1
     exec \
     tcpserver -1vpdl0 -Xxtcp.cdb 0 ssh \
     sshd -ief config

This service needs a log service to be set up.

### A `statd` run script

(Debian woody)

     #!/bin/sh
     exec 2>&1
     NEED_LOCKD=yes
     if test -f /proc/ksyms; then
       # We need to be conservative and run lockd,
       # unless we can prove that it isn't required.
       grep -q lockdctl /proc/ksyms || NEED_LOCKD=no
     fi
     if [ "$NEED_LOCKD" = yes ]; then
       rpc.lockd
     fi
     exec rpc.statd -F -d

This service needs a log service to be set up.

### A `mountd` run script

(Debian)

     #!/bin/sh
     sv start portmap statd || exit 1
     RPCNFSDCOUNT=8  # Number of servers to be started up by default
     RPCMOUNTDOPTS=

     trap '/usr/bin/killall -2 nfsd' 0
     trap 'exit 2' 1 2 3 15

     exportfs -r
     rpc.nfsd -- $RPCNFSDCOUNT
     rpcinfo -u localhost nfs 3 >/dev/null 2>&1 ||
       RPCMOUNTDOPTS="$RPCMOUNTDOPTS --no-nfs-version 3"
     exec rpc.mountd -F $RPCMOUNTDOPTS

### A `stunnel` run script

(BSD)

     #!/bin/sh
     exec /usr/local/sbin/stunnel -f -d 1234 -r 25 -v3 -a /etc/ssl/mailcerts 2>&1

### A `svnserve` run script

(Debian)

     #!/bin/sh
     exec 2>&1
     exec /usr/bin/svnserve -d --foreground

### A `swat` run script

     #!/bin/sh
     exec 2>&1
     exec tcpsvd -l0 127.0.0.1 901 swat

### A `syslogd` run script

(Debian sarge)

     #!/bin/sh
     exec syslogd -n

### A `taiclockd` run script

     #!/bin/sh
     exec 2>&1
     exec setuidgid taiclock /usr/local/clockspeed/bin/taiclockd

### A `tmda-ofmipd` run script

(RedHat 7)

     #!/bin/sh
     exec /usr/local/tmda/bin/tmda-ofmipd -f -d -R pop3 -p my.host.name:8025 2>&1

This service needs a log service to be set up.

### A `tomcat` run script

(SunOS)

     #!/bin/sh
     exec 2>&1
     exec \
     setuidgid apache \
     /pack/tomcat/current/bin/catalina.sh run

### A `tor` run script

(Debian sarge)

     #!/bin/sh
     exec 2>&1
     exec chpst -P -u debian-tor:debian-tor tor

### A `vsftpd` run script

(RedHat 7)

     #!/bin/sh
     exec 2>&1
     exec tcpserver -c30 -Xv -llocalhost \
       -x/etc/tcp.ftp.cdb -uvsftpd -gvsftpd 0 ftp \
         softlimit -d300000 /var/vsftpd/bin/vsftpd

This service needs a log service to be set up.

### A `wvdial` run script

(Slackware Linux 9.0, the service should have a `down` file, use `svc -o /service/wvdial` to bring up a ppp connection)

     #!/bin/sh
     exec 2>&1
     exec wvdial ISP

This service needs a log service to be set up.

### A `xdm` run script

(Linux)

     #!/bin/sh
     sv start /service/vc-* || exit 1
     exec xdm -nodaemon

### A `xfs` run script

(Debian sarge)

     #!/bin/sh
     SOCKET_DIR=/tmp/.font-unix
     mkdir -p $SOCKET_DIR
     chown 0:0 $SOCKET_DIR
     chmod 1777 $SOCKET_DIR
     exec /usr/bin/X11/xfs -nodaemon

$Id: runscripts.html,v 1.37 2006/11/14 23:32:26 pape Exp $