snow: How To Install

How To Install

Note: Code is currently undergoing a compatibility-breaking rewrite. Installing the published version right now is not recommended, and to discourage this the network bootstrap node is not running.

First install build dependencies:

# apt-get install git g++ make libssl-dev


# apt-get install libminiupnpc-dev libnatpmp-dev

Now get the code and compile it:

$ git clone git://  
$ cd snow/src  
$ make -j5

If you don't want UPnP or NAT-PMP or get an error related to libminiupnpc (e.g. Ubuntu 14.04 ships an incompatible version), you can compile without them:

$ make -j5 NO_UPNP=1 NO_NATPMP=1

Install (as root):

# make install

Now add a firewall rule to drop packets from the snow address pool (by default from all other interfaces. If you are already using this address range for something then choose a different one (see Advanced Configuration). You do not have to use the same address pool as other devices running snow. The first address in the pool will by default be the virtual address of your own device.

# iptables -I INPUT -s ! -i snow0 -j DROP  
# iptables -I INPUT -s -i lo -j ACCEPT  
# apt-get install iptables-persistent  
# iptables-save > /etc/iptables/rules.v4

The "snowd" and "sdnsd" binaries you installed should now work if started as root, but first a reminder about what "automatic NAT traversal" means. It's a bit like having an IPv6 address. Packets from The Internet will come to Your Computer. If you want to turn off any services or set any appropriate firewall rules, now is the time. This is your final warning.

At this point you can try to start the daemons (use "-d" to run in background):

# snowd -d  
# sdnsd -d

You should get some messages in the system log:

# tail -n20 /var/log/syslog

Now set your DNS server to you should be able to do this:

$ ping local.key  
PING local.key ( 56(84) bytes of data.  
64 bytes from baaaac6rxjmmenb7m5txgpe3nmmrrh4z4ohcr7sxqkrvbk4csbrrorpw7.key ( icmp_seq=1 ttl=64 time=0.036 ms  
64 bytes from baaaac6rxjmmenb7m5txgpe3nmmrrh4z4ohcr7sxqkrvbk4csbrrorpw7.key ( icmp_seq=2 ttl=64 time=0.069 ms  

You should (theoretically) now be able to reach your device using its key from some other device running snow. If it works then you can schedule "/usr/sbin/snowd -d" and "/usr/sbin/sdnsd -d" to run at boot in the usual way.

If you got this far and it worked (or it didn't), let me know.

[snow] [How it works] [How to use it] [How to install it] [Advanced Configuration] [App Development] [Read the FAQ]