Source download:

To compile snowbox yourself you need a Go compiler. It has been tested with the official release but it should also work with the gcc go compiler.

The reference implementation is available at: It is also included in Debian Wheezy. If you can type "go" on the command line and it produces something other than "command not found" you're good to go.

To install:

$ make
$ sudo make install

This will install the binary in /usr/local/sbin, the config in /etc/snowbox and a simple init script in /etc/init.d.

If you're on Debian you can use the provided init script init.d/debian for a more "debianized" version. To add snowbox to the startup on Debian use

$ update-rc.d snowbox defaults.

After that you should edit /etc/snowbox/config to suit your needs and add the users to /etc/snowbox/user.auth. The configuration is pretty much self explanatory. See the manpage for more details about what can be done.

Binary distribution:


$ sudo make install

These packages are the same as the source version with snowbox precompiled. You can recompile them yourself with 'make'.


You can create a self-signed certificate to use with snowbox with:

$ make ssl-cert

This will create a certificate valid for one year with the common name 'localhost'. You need OpenSSL installed. The command line for creating certificates:

openssl req -new -x509 -nodes -out snowbox.cert -keyout snowbox.key -days 365 -subj '/CN=localhost'

Change 'CN=localhost' accordingly.


$ make uninstall

This will uninstall the binary, init script and manpage. To remove the config

$ make uninstall-conf