Obsolete, using nodeos-init instead
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Obsolete, using nodeos-init instead

This repo will remain for reference purposses

NodeOS Init

The init process, typically /sbin/init, is a long-lived process started by the kernel during boot. Init is responsible for starting system daemons such as sshd, getty, and dhcp.

On Ubuntu the init daemon is Upstart. Upstart, like most init daemons, has the concept of a system runlevel numbered 0-5. When init starts, it uses the runlevel to decide how to boot the system. The startup sequence involves parsing files in /etc/rcX.d, /etc/init, and /etc/init.d.

The NodeOS init daemon takes a different approach. The init daemon does nothing except basic job control.

  • Init starts an HTTP server on that can be used to start and stop jobs.
  • Init hands control to another process that uses the API to boot the system as desired.
  • Init itself does not parse config files.


GET    /jobs               <-- list all jobs
POST   /job                <-- start a job
PUT    /job/:id            <-- start a job with a specific name
PUT    /job/:id/sig/:sig   <-- signal a process
GET    /job/:id            <-- get job info
DELETE /job/:id            <-- clear a stopped job

Starting a job requires a JSON payload

  "exec": "node",
  "args": [ "server.js" ],
  "cwd" : "/var/www",
  "envs": {
    "PORT": "80",
    "PATH": "/bin:/root/bin"
  "user": "www",
  "group": "www"


  • restart semantics
  • handling stdio
  • pre-opened file-descriptors
  • authentication and access control


init [next command and args]

After init starts its HTTP server, it passes the task of booting the system off to another process. You specify the next process by passing the command to init during start. These parameters can, and should, be passed to init by grub.

The next command effectively decides what order to boot system daemons in. The npkg command defined in nodeos-npkg provides a nice interface between init and NodeJS packages installed on the system.