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

Gerrit Pape <pape@smarden.org>
$Id$