Installing the CLI

In order to upload programs to Codius hosts, you'll need to install the CLI.

npm install -g codius

Example Applications

Codius has a number of example applications to help you get started, which you can acquire by cloning this repo:

git clone https://github.com/codius/examples

nginx

The first example is a simple nginx server:

  • cd codius-examples/manifest/
  • codius upload ./nginx-manifest.json --host https://codius.feraltc.com

You should get a response that looks something like this:

{ url:
   'https://MANIFEST_HASH.codius.feraltc.com/',
  manifestHash: 'MANIFEST_HASH',
  host: 'https://codius.feraltc.com',
  expiry: '2018-06-05T20:52:02.068Z',
  expirationDate: '06-05-2018 1:52:02 -0700',
  expires: 'a few seconds ago',
  pricePaid: '4' }

Notice the url field in the response. You can use this url to query the pod you just launched, and it should return the standard nginx welcome page.

create-react-app

Another available example pod launches the bootstrap React App, create-react-app.

  • cd codius-examples/manifest/
  • codius upload ./create-react-app-manifest.json --host https://codius.feraltc.com

As before, you should get a simliar response:

{ url:
   'https://MANIFEST_HASH.codius.feraltc.com/',
  manifestHash: 'MANIFEST_HASH',
  host: 'https://codius.feraltc.com',
  expiry: '2018-06-05T20:52:02.068Z',
  expirationDate: '06-05-2018 1:52:02 -0700',
  expires: 'a few seconds ago',
  pricePaid: '4' }

Feel free to test these examples with some of the other hosts that the Codius team are running:

  • https://codius.justmoon.com
  • https://codius.tinypolarbear.com
  • https://codius.risky.business
  • https://codius.andros-connector.com