OS.js

OS.js - JavaScript Web Desktop Platform

Stars
6.7K
Forks
869
Open issues
16
Closed issues
596
Last release
almost 3 years ago
Last commit
almost 2 years ago
Watchers
6.7K
Total releases
42
Total commits
65
Open PRs
1
Closed PRs
146
Repo URL
Platform
License
other
Category
Usecase
Offers premium version?
NO
Proprietary?
NO
About

OS.js

OS.js is an open-source web desktop platform with a window manager, application APIs, GUI toolkit, filesystem abstractions and much more.

Backing/Donations: Github sponsorship, Patreon, OpenCollective, LibrePay, PayPal, Bitcoin

Support: Chat, Forums, Twitter, Facebook

Introduction

This is the OS.js base repository that you can use as a template to make your own distributions, installations and development environments.

Try it yourself

Visit the official demo for a preview version. Please note that some features are disabled and might be outdated or unavailable at times.

Documentation

See the official manuals for articles, tutorials and guides.

There's also a contribution guide if you want to contribute to this project.

Installation

OS.js runs on http://localhost:8000 by default.

Using a pre-made image

You can use the official Docker base image to run OS.js without downloading this repository.

This image is based on this source code and comes with a minimal setup.

docker run -p 8000:8000 osjs/osjs:latest
Using this repository

Clone the master branch:

You can also download an archived version (ex. zip file) instead of using git.

git clone -b master --single-branch https://github.com/os-js/OS.js.git
cd OS.js
Docker Compose installation

The easiest way to install is to use Docker Compose. This allows you to run a single command to set everything up:

docker-compose up
Local installation

You can also install this directly onto your system by using the following set of commands.

NOTE: Requires Node v10 (or later. node 17 not currently supported without workaround).

# Install dependencies
npm install

It's recommended that you update dependencies

npm update

Optionally install extra packages:

For a list of packages, see https://manual.os-js.org/resource/official/

npm install @osjs/example-application

Discover installed packages

npm run package:discover

Build client

npm run build

Start serving

npm run serve

Alternative Projects
No projects found

Subscribe to Open Source Businees Newsletter

Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.

We'll never share your email with anyone else.