From Alpine Linux
Revision as of 22:24, 15 January 2014 by Ginjachris (talk | contribs)
Jump to: navigation, search
Underconstruction clock icon gray.svg
This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by Ginjachris on 15 Jan 2014.)

Darkhttpd is a simple, fast HTTP 1.1 web server for static content. It does not support PHP or CGI etc but is designed to serve static content, which it does very well. Darkhttpd would be an excellent alternative to Lighttpd for running an Alpine mirror

For a full list of features see the [darkhttpd homepage]


apk add darkhttpd


Default location of files to serve: /var/www/localhost/hdocs

Default log path: /var/log/darkhttpd/access.log

There's no configuration file for darkhttpd, everything is controlled from the command line or in our case the OpenRC init file, which is stored in /etc/init.d/darkhttpd and by default looks like this:

#! /sbin/runscript

description="darkhttpd web server"
command_args="${document_root:-/var/www/localhost/htdocs} --chroot --daemon --uid darkhttpd --gid www-data --log /var/log/darkhttpd/access.log"

So by default we will serve pages from /var/www/localhost/hdocs and darkhttpd will run as a background daemon, chrooted to /var/www/localhost/hdocs with a user of darkhttpd and group of www-data. Logs will go to /var/log/darkhttpd/access.log. The default values have been chosen to provide sane, secure settings.

Change any of these values as you see fit, but it's a good idea to backup the file before making changes.

For a full list of available options, run:


and amend the command_args line as you see fit.


Filesharing is made easy; simply add your files under /var/www/localhost/hdocs


Create a test page under /var/www/localhost/hdocs

echo "this is a test page" > /var/www/localhost/htdocs/index.html

Note: You don't have to create a test page; in a working environment darkhttpd will generate a directory listing if no index page is found.

Start the daemon:

rc-service darkhttpd start

Output should be something like this:

 * Starting darkhttpd ...
darkhttpd/1.9, copyright (c) 2003-2013 Emil Mikulic.
listening on:
chrooted to `/var/www/localhost/htdocs'
set gid to 82
set uid to 100                                

Now point a browser to your darkhttpd server and you should get the index page, or a directory listing if you didn't create an index page.

Check the logfile:

tail /var/log/darkhttpd/access.log

Controlling darkhttpd status

Stop, start and restart the daemon in the usual fashion:

rc-service darkhttpd start

rc-service darkhttpd stop

rc-service darkhttpd restart

Auto-start darkhttpd at boot

To add the daemon to the default runlevel so it auto-starts at boot, do:

rc-update add darkhttpd

man darkhttpd

v-alpine-server:~# darkhttpd
darkhttpd/1.9, copyright (c) 2003-2013 Emil Mikulic.
usage:  darkhttpd /path/to/wwwroot [flags]

flags:  --port number (default: 8080, or 80 if running as root)
                Specifies which port to listen on for connections.

        --addr ip (default: all)
                If multiple interfaces are present, specifies
                which one to bind the listening port to.

        --maxconn number (default: system maximum)
                Specifies how many concurrent connections to accept.

        --log filename (default: stdout)
                Specifies which file to append the request log to.

        --chroot (default: don't chroot)
                Locks server into wwwroot directory for added security.

        --daemon (default: don't daemonize)
                Detach from the controlling terminal and run in the background.

        --index filename (default: index.html)
                Default file to serve when a directory is requested.

        --mimetypes filename (optional)
                Parses specified file for extension-MIME associations.

        --uid uid/uname, --gid gid/gname (default: don't privdrop)
                Drops privileges to given uid:gid after initialization.

        --pidfile filename (default: no pidfile)
                Write PID to the specified file.  Note that if you are
                using --chroot, then the pidfile must be relative to,
                and inside the wwwroot.

                Disables HTTP Keep-Alive functionality.

        --forward host url (default: don't forward)
                Web forward (301 redirect).
                Requests to the host are redirected to the corresponding url.
                The option may be specified multiple times, in which case
                the host is matched in order of appearance.

                Don't identify the server type in headers
                or directory listings.