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.


atftpd
apache
apache2
bind9
boa
cfengine
chrony
clamav
courier-imap
cups
dhclient
dhcpcd
dhcpd
dropbear
exim
expireproctitle
fam
fcron
gdm
getty
gpm
hotwayd
identd
inn
jabberd
keepalived
klogd
leafnode
logging Linux kernel messages
logging console messages
minidentd
mysql
ntpd
polipo
pop3-ssl
pop3vscan
portmap
postgresql
ppp
proftpd
pure-ftpd
radiusd
rsyncd
samba (smbd, nmbd)
shoutcast
spamd
squid
sshd
sshd under tcpserver
statd, mountd
stunnel
swat
taiclockd
tmda-ofmipd
tomcat
vsftpd
wvdial
xdm

An atftpd run script

(Debian)
 #!/bin/sh
 exec /usr/sbin/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

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 /usr/sbin/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 chrony run script

(LFS)
 #!/bin/sh
 exec 2>&1
 exec  /usr/sbin/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 /usr/local/bin/setuidgid clamav \
   /usr/local/bin/softlimit -a 40000000 /usr/local/sbin/clamd
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 cups run script

(Debian woody)
 #!/bin/sh
 exec 2>&1
 exec /usr/sbin/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
 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 /command/envdir ./env /usr/lib/inet/dsvclockd -f
 #!/bin/sh
 if /command/svok /service/dsvclockd; then
   /usr/bin/sleep 2 # wait to make sure dsvclockd is initialized
   exec 2>&1
   exec /command/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 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 /usr/bin/fam -L -f -v
This service needs a log service to be set up.

A fcron run script

(LFS)
 #!/bin/sh
 exec 2>&1
 exec /usr/sbin/fcron -f -y
This service needs a log service to be set up.

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 /sbin/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 /usr/sbin/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 /usr/local/bin/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 /usr/local/bin/setuidgid jabberd \
   /usr/local/jabber/jit/jabberd/jabberd -c /etc/jit.xml
This service needs a log service to be set up.

A keepalived run script

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

A klogd run script

(Debian woody)
 #!/bin/sh
 exec /sbin/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 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 mysql run script

(SunOS)
 #!/bin/sh
 exec setuidgid mysql /pack/mysql/current/libexec/mysqld \
         --basedir=/pack/mysql/current \
         --datadir=/pack/mysql/data/ \
         --socket=/tmp/mysql.sock \
         --pid-file=/pack/mysql/data/mysql.pid 2>&1
(LFS)
 #!/bin/sh
 exec 2>&1
 exec /usr/sbin/mysqld -u mysql
(Debian, ``It's an ugly hack, but it works'')
 #!/bin/sh
 cd /
 umask 077
 
 MYSQLADMIN='/usr/bin/mysqladmin --defaults-extra-file=/etc/mysql/debian.cnf'
 
 trap "$MYSQLADMIN shutdown" 0
 trap 'exit 2' 1 2 3 15
 
 /usr/bin/mysqld_safe & wait

A ntpd run script

(Linux)
 #!/bin/sh
 MEM="`head -1 ./env/MEM`"
 exec softlimit -m ${MEM} \
   ntpd -n -p /var/run/ntpd.pid

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 /usr/local/bin/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 /usr/local/bin/setuidgid pop3vscan /usr/sbin/pop3vscan -d
This service needs a log service to be set up.

A portmap run script

(LFS)
 #!/bin/sh
 exec 2>&1
 exec /sbin/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 ppp run script

(FreeBSD)
 #!/bin/sh
 exec 2>&1
 echo "ppp -ddial dsl "
 exec /usr/sbin/ppp -unit0 -foreground dsl

A pppd run script

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

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 /usr/sbin/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 rsyncd run script

(SunOS)
 #!/bin/sh
 exec 2>&1
 exec softlimit -d 100000000 /usr/local/bin/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, samba patched to run supervised)
 #!/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, samba patched to run supervised)
 #!/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 /usr/local/bin/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 /usr/sbin/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 woody, sshd version OpenSSH_2.9p2)
 #!/bin/sh
 exec 2>&1
 exec 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
   /sbin/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
svwaitup /var/service/statd
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

/usr/sbin/exportfs -r
/usr/sbin/rpc.nfsd -- $RPCNFSDCOUNT
/usr/bin/rpcinfo -u localhost nfs 3 >/dev/null 2>&1 ||
  RPCMOUNTDOPTS="$RPCMOUNTDOPTS --no-nfs-version 3"
/usr/sbin/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 swat run script

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

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 vsftpd run script

(RedHat 7)
 #!/bin/sh
 exec 2>&1
 exec /usr/local/bin/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
 svwaitup -s 2 /service/vc-*
 exec xdm -nodaemon

Gerrit Pape <pape@smarden.org>
$Id: runscripts.html,v 1.24 2004/09/20 19:53:10 pape Exp $