Documentation > Installation > Installation on FreeBSD

Installation on FreeBSD

There are two methods of installing Crossbar.io on FreeBSD -- from the official binary distribution (recommended), or from source.

Installing the Official Distribution

Crossbar.io hosts official binary packages for FreeBSD 10.1/10.2/10.3.

If this is not the version of FreeBSD you are using, please install from source as mentioned below.

First, install Crossbar's software signing key:

mkdir -p /usr/local/etc/ssl/certs/
cat >> /usr/local/etc/ssl/certs/crossbar.cert << EOT
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzlYpaiHktflMhsXVIT03
yH+tS7IgFrucL6Hqpa394WUR8w23Ua1PtoQruj7sn4ZkmA02g2qzSJ8A9DdgYFBE
0AHqAEIzVljGXYWN8FmULs290WpL9R6pSp0mDcpFu+FEhaeQXC0t7wjlZOpEpiV+
vDeX+/Mnf1yW75sE9gbRqT4zfmz6oIE9LIWkqW9CKiV0+XvmsSLRg6fJfKfi77GM
Wg8DzIHo4ssWr3AqpXABxnV+euXHGViYCzCMjOxW7lRmEm4ySPanZokKIpUBtKhA
SNchklvN4JfYSQuE3P+d3Amx0st6SnTeEB6/du9lwJ5PpK+tF2JblOIdkMy5+TkU
wwIDAQAB
-----END PUBLIC KEY-----
EOT

Then install the Crossbar package repository:

mkdir -p /usr/local/etc/pkg/repos/
cat >> /usr/local/etc/pkg/repos/crossbar.conf << EOT
crossbar: {
  url: "http://package.crossbar.io/freebsd/10",
  mirror_type: "http",
  signature_type: "pubkey",
  pubkey: "/usr/local/etc/ssl/certs/crossbar.cert",
  enabled: yes
}
EOT

Update your pkg cache:

pkg update

Install Crossbar:

pkg install crossbar

Then test your installation:

/opt/crossbar/bin/crossbar version

You're done!

Installing from Source

For installing PyPy on FreeBSD, please follow this.

Add the following to $HOME/.profile (adjusting the path to PyPy according to the one you unpacked):

export PATH=${HOME}/pypy-c-jit-68238-4369d6c2378e-freebsd64/bin:${PATH}

and

source $HOME/.profile

Then install pip:

wget --no-check-certificate https://raw.github.com/pypa/pip/master/contrib/get-pip.py
pypy get-pip.py

Installing Crossbar.io

To install Crossbar.io

pip install -e .[all]

You can then test the installation by printing out the versions of the Crossbar components.

crossbar version

To update an existing Crossbar.io installation:

pip install --upgrade -e .[all]

You're done!