Installation is done in a few simple steps and only takes a couple of minutes.


The only dependency is node 8 or later and git is recommended.

A node Docker setup is also provided so you don't need to have node installed locally (or want to have an isolated environment).

Runs in any modern web browser.


You can run a demo using Docker without checkout out any source-code:

docker run -p 8000:8000 osjs/osjs:v3


Make sure to read the deployment guide if you plan on installing in a production environment.

[warning] Do not use "sudo" or an administrator user for the setup procedure.

Clone the base repository (or download a compressed version of latest release):

git clone -b v3 --single-branch
cd OS.js

Manual Setup

To install locally you have to run a couple of commands to set up your distribution:

# Install dependencies
npm install

# Optionally install extra packages:
# For a list of packages see
npm install --save @osjs/example-application

# Discover installed packages
npm run package:discover

# Build the client bundle
npm run build

# And finally start the server
npm run serve

Now open http://localhost:8000 in your browser to launch OS.js.

Docker Setup

A Docker setup is also provided (mainly aimed at development). It performs all the necessary steps for you:

cp .env.example .env
docker-compose up

Now open http://localhost:8000 in your browser to launch OS.js.


You can list outdated packages with npm outdated.

To upgrade, use npm update.

It is also recommended that you run npm run package:discover afterwards.

Make sure to read the migration guide before you update for any special notices.

Releases uses semantic versioning so if an update has breaking changes the npm update command will not upgrade to the latest release. You'll have to do it manually by using npm install <package>@^<version>.

results matching ""

    No results matching ""