The Canopy team operates a large-scale deployment of the Canopy Server that you can use to develop and launch your cloud-enabled products and services. Our servers are hosted in a world-class datacenter with high availability.

• https://sandbox.canopy.link: Free deployment for learning Canopy and developing smart products.
• Contact Us for a dedicated deployment.

Learn more about our hosted offerings on our Services page.

The Canopy Server is completely open source and licensed under the highly-permisive Apache v2.0 license. It is easy to deploy your own instance of the server by following the installation instructions in this document.

Using the text editor of your choice, edit /etc/apt/sources.list.d/cassandra.sources.list:

sudo vim /etc/apt/sources.list.d/cassandra.sources.list

Add the following line:

deb http://debian.datastax.com/community stable main

Save and exit. Then run:

curl -L http://debian.datastax.com/debian/repo_key | sudo apt-key add -
sudo apt-get update
sudo apt-get install -y cassandra=2.0.7

Run:

sudo apt-get install -y python-software-properties
sudo add-apt-repository ppa:webupd8team/java

Press ENTER when prompted. The run:

sudo apt-get update
sudo apt-get install -y oracle-java7-installer

When prompted, press ENTER. Then select "Yes" and press ENTER.

Download the latest release on our Release Package Downloads page. Look for the ".deb x64 64-bit Binary Package".

In the directory where you downloaded the release package, install the Canopy Server with this command (replacing XX.YY.ZZ-W with the version number you downloaded):

sudo dpkg -i canopy-server_XX.YY.ZZ-W_amd64.deb

You can now skip ahead to Configuring and Running.

Alternatively you can build the Canopy Server from source by cloning the github repository. This section walks you through the steps.

Install golang. Canopy does not work with the old version of golang that Ubuntu's "apt-get" installs. We recommend manually installing version go1.4.2:

sudo apt-get install -y git make mercurial
wget https://storage.googleapis.com/golang/go1.4.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.4.2.linux-amd64.tar.gz
echo PATH=/usr/local/go/bin:\$PATH >> ~/.profile
source ~/.profile

Clone the Canopy Server repository:

git clone https://github.com/canopy-project/canopy-server

Build the project:

cd canopy-server
make

You should see this output:

make -C src/canopy go_get_deps
make[1]: Entering directory `/home/ubuntu/canopy-server/src/canopy'
mkdir -p ~/.canopy/golang
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get code.google.com/p/go.net/websocket
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get github.com/gocql/gocql
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get github.com/gorilla/sessions
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get github.com/gorilla/context
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get github.com/gorilla/mux
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get github.com/sendgrid/sendgrid-go
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go get code.google.com/p/go.crypto/bcrypt
make[1]: Leaving directory `/home/ubuntu/canopy-server/src/canopy'
make -C src/canopy all
make[1]: Entering directory `/home/ubuntu/canopy-server/src/canopy'
mkdir -p ~/.canopy/golang
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go build canopy-cloud-service.go canopy_cloud.go canopy_json.go
mkdir -p build/
mv canopy-cloud-service build/
mkdir -p ~/.canopy/golang
GOPATH=$(cd ~/.canopy/golang; pwd):$(cd ../../; pwd) go build canopy_cmd.go
mkdir -p build/
mv canopy_cmd build/canodevtool
make[1]: Leaving directory `/home/ubuntu/canopy-cloud/src/canopy'

Install it:

sudo make install

You should see this output:

src/canopy install
make[1]: Entering directory `/home/ubuntu/canopy-cloud/src/canopy'
cp build/canopy-cloud-service build/canodevtool /usr/local/bin
cp ../../scripts/canopy-cloud-service /etc/init.d
mkdir -p /etc/canopy
cp ../../scripts/ccs-env.sh /etc/canopy
../../scripts/create-canopy-group-user.sh
id: canopy: no such user
Adding group `canopy' (GID 114) ...
Done.
id: canopy: no such user
Adding system user `canopy' (UID 108) ...
Adding new user `canopy' (UID 108) with group `canopy' ...
Not creating home directory `/home/canopy'.
mkdir -p /var/log/canopy
touch /var/log/canopy/ccs.log
touch /var/log/canopy/ccs-errors.log
chown canopy /var/log/canopy
chgrp canopy /var/log/canopy
chown canopy /var/log/canopy/ccs.log
chgrp canopy /var/log/canopy/ccs.log
chown canopy /var/log/canopy/ccs-errors.log
chgrp canopy /var/log/canopy/ccs-errors.log
make[1]: Leaving directory `/home/ubuntu/canopy-cloud/src/canopy'

One last step before running the Canopy Server. We must configure it. Edit the file:

/etc/canopy/server.conf

Change the "hostname" to match the IP address or hostname of your server.

There a many other configuration options you can modify. Learn more about configuring the server in the Configuration chapter.

Start Cassandra running:

sudo cassandra

You should see a bunch of text scroll, ending with:

INFO 17:24:59,576 Completed flushing /var/lib/cassandra/data/system/local/system-local-jb-3-Data.db (114 bytes) for commitlog position ReplayPosition(segmentId=1410197098396, position=91604)
INFO 17:24:59,644 CFS(Keyspace='system', ColumnFamily='local') liveRatio is 27.44988344988345 (just-counted was 3.515151515151515).  calculation took 5ms for 257 cells
INFO 17:24:59,644 Enqueuing flush of Memtable-local@414544706(10098/277188 serialized/live bytes, 259 ops)
INFO 17:24:59,645 Writing Memtable-local@414544706(10098/277188 serialized/live bytes, 259 ops)
INFO 17:24:59,677 Completed flushing /var/lib/cassandra/data/system/local/system-local-jb-4-Data.db (5275 bytes) for commitlog position ReplayPosition(segmentId=1410197098396, position=103603)
INFO 17:24:59,693 Compacting [SSTableReader(path='/var/lib/cassandra/data/system/local/system-local-jb-1-Data.db'), SSTableReader(path='/var/lib/cassandra/data/system/local/system-local-jb-3-Data.db'), SSTableReader(path='/var/lib/cassandra/data/system/local/system-local-jb-4-Data.db'), SSTableReader(path='/var/lib/cassandra/data/system/local/system-local-jb-2-Data.db')]
INFO 17:24:59,780 Node localhost/127.0.0.1 state jump to normal

Press ENTER to return to the command-line.

Create the database:

canopy-ops create-db

Now, you can start the Canopy Server

sudo /etc/init.d/canopy-server start

To check that it is working, go to https://<ip_address>/api/info in your web browser. You should see something like the following response:

{
    "clock_us": 1427847182641191,
    "clock_utc": "2015-04-01T00:13:02.641191Z",
    "config": {
        "allow-anon-devices": true,
        "allow-origin": "",
        "email-service": "sendgrid",
        "enable-http": false,
        "enable-https": true,
        "forward-other-hosts": "",
        "hostname": "dev02.canopy.link",
        "http-port": 80,
        "https-cert-file": "/etc/canopy/cert.pem",
        "https-port": 443,
        "https-priv-key-file": "/etc/canopy/key.pem",
        "js-client-path": "/home/gregp/development/canopy/canopy-js-client",
        "log-file": "/var/log/canopy/server.log",
        "sendgrid-username": "canopy-mailer",
        "web-manager-path": "/home/gregp/development/canopy/canopy-app"
    },
    "result": "ok",
    "service-name": "Canopy Cloud Service",
    "version": "15.04.03"
}

If you see anything other than that, there was most likely a problem. You can view the log file by typing:

cat /var/log/canopy/server.log