Skip to content

Installation and Usage

Sten Feldman edited this page Jul 24, 2019 · 6 revisions

Getting started

Pylon 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.

Pylon requirements for v2.5.0+

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

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

Install:

Altough available via npm as pln it is recommended to install directly from Github. To install:

# Grab the source:
git clone https://github.com/pylonide/pylon.git pylon
cd pylon
npm i

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

cd pylon
bin/pylon.sh

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

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

Pylon 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 Pylon 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/pylon.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 Pylon, or use the built in basic authentication through the --username and --password flags.

bin/pylon.sh --username leuser --password plnisawesome

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