Skip to content

Installation and Usage

Sten Feldman edited this page Oct 6, 2017 · 6 revisions

Getting started

Cloud9 is based on a popular, open-source, cross-platform JavaScript run-time environment called Node.js. Additionally, functionality of this app relies of dependency modules written in Node.js ecosystem some of which is still rapidly evolving. Going forward the goal of this maintenance fork is to support the official Node.js versions based on the LTS calendar.

Cloud9 requirements for v2.2.0+

  • NodeJS >= 4.8.4
  • g++-4.8
  • make
  • python

Cloud9 requirements for v2.1.x

  • NodeJS >= 0.10.0
  • g++-4.8
  • make
  • python

(The g++, make and python are required for the PTY component that Cloud9 uses to provide a working terminal)

Install:

This project is not available currently via package repositories. To install:

# Grab the source:
git clone https://github.com/exsilium/cloud9.git cloud9
cd cloud9
npm install

The above install steps create a cloud9 directory in your current directory. Just cd into it and run bin/cloud9.sh to start:

cd cloud9
bin/cloud9.sh

Optionally, you may specify the directory you'd like to edit:

bin/cloud9.sh -w ~/git/myproject

Cloud9 will be started as a web server on port -p 3131, you can access it by pointing your browser to: http://localhost:3131

By default Cloud9 will only listen to localhost. To listen to a different IP or hostname, use the -l HOSTNAME flag. If you want to listen to all IP's:

bin/cloud9.sh -l 0.0.0.0

If you are listening to all IPs it is adviced to add authentication to the IDE. You can either do this by adding a reverse proxy in front of Cloud9, or use the built in basic authentication through the --username and --password flags.

bin/cloud9.sh --username leuser --password c9isawesome

Cloud9 is compatible with all connect authentication layers, to implement your own, please see the plugins-server/cloud9.connect.basic-auth plugin for how basic authentication was added.