INSTALL

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: http://golang.org/doc/install
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:

Use

$ sudo make install

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


SSL:

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.


Uninstalling:

$ make uninstall

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

$ make uninstall-conf