To use the Codius command-line interface (CLI), you need a recent version of 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/trusty32vagrant upvagrant ssh
Congratulations, you are running Ubuntu/Linux! Proceed.
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 i386sudo apt-get updatesudo apt-get install libc6-i386 lib32stdc++6 libseccomp2:i386
Install git by running:
sudo apt-get install git
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.jssudo apt-get updatesudo apt-get install nodejssudo ln -s /usr/bin/nodejs /usr/local/bin/node
To install Codius command line tools, run:
sudo npm install -g codius
Now let's verify everything installed ok.
Let's check out an application and run it!
git clone https://github.com/codius/example-helloworld codius-example-helloworldcd codius-example-helloworldcodius run
You should see something like:
Codius applications can expose HTTP APIs, check it out:
git clone https://github.com/codius/example-webserver codius-example-webservercd codius-example-webservercodius serve
You should see an message like
Localhost server listening on port: 8000 meaning your application is now running at
localhost:8000. Go ahead and open it in a browser!
You can upload contracts to Codius hosts.
NOTE: Before attempting to upload an application, it is important to first test it with Node and then with Codius using:
If your application runs with issues, you are ready to upload!
First, set yourself up with a local Codius host and run:
Now you can go back to the
codius-example-webserver folder from the previous example and run
cd codius-example-webservercodius upload --hosts https://localhost:2633
Now your application is running on the Codius host! Go ahead and open its URL in the browser and watch its output in the host's log!
To upload your application to one or more remote Codius hosts, specify the hosts using
--hosts. Multiple hosts can be listed using commas without spaces:
codius upload --hosts https://remote-host-1.com,https://remote-host-2.com
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 upload --hosts https://self-signed-host.com