codius

Codius Command-Line Interface (CLI)

Prerequisites

To use the Codius command-line interface (CLI), you need a recent version of Linux.

Linux

For the example commands below, we assume you're on Ubuntu 14.04 or later. But most up-to-date Linux distributions should work. We definitely recommend being on the latest stable release though.

If you're on Windows/Mac try installing Vagrant and then run:

vagrant init ubuntu/trusty32
vagrant up
vagrant ssh

Congratulations, you are running Ubuntu/Linux! Proceed.

32-bit libc/libstdc++ (Skip if you're using Vagrant or a 32-bit installation)

On 64-bit systems you need to have the 32-bit versions of libc, libstdc++ and libseccomp installed.

On Ubuntu, run:

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install libc6-i386 lib32stdc++6 libseccomp2:i386

git

Install git by running:

sudo apt-get install git

Node.js

Next, you need a recent version of Node.js. All versions of 0.10.x or higher should work.

On Ubuntu, you can install Node.js simply by:

sudo add-apt-repository ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get install nodejs
sudo ln -s /usr/bin/nodejs /usr/local/bin/node

Installation

To install Codius command line tools, run:

sudo npm install -g codius

Verification

Now let's verify everything installed ok.

codius selftest

Getting started

Hello world

Let's check out a contract and run it!

git clone https://github.com/codius/example-helloworld codius-example-helloworld
cd codius-example-helloworld
codius run

You should see something like:

Contracts are servers

Contracts can expose HTTP APIs, check it out:

git clone https://github.com/codius/example-webserver codius-example-webserver
cd codius-example-webserver
codius serve

Your contract is now running at localhost:2634. Go ahead and open it in a browser!

Uploading contracts

Warning, this functionality is still heavily under development.

You can upload contracts to Codius hosts. First, let's set up a local Codius host:

git clone https://github.com/codius/codius-host
cd codius-host
npm install
node app

Now you can go back to the codius-example-webserver folder from the previous example.

To upload your contract, run codius upload.

cd codius-example-webserver
CODIUS_HOST=https://codius-host-name.com:2633 codius upload

Now your contract is running on the Codius host! Go ahead and open its URL in the browser and watch its output in the host's log!

Using Self-Signed SSL Certificates

If your Codius Host is using a self-signed SSL certificate (potentially for development) you will need to enable tls connections with self-signed certs by setting the CODIUS_UNAUTHORIZED_SSL environment variable to true

CODIUS_UNAUTHORIZED_SSL=true CODIUS_HOST=https://codius-host-name.com:2633 codius upload