Documentation

Host Onset yourself

Run onset-server: one binary with SQLite and a folder of objects.

onset-server is one binary that speaks the same protocol as upstream.codes. It keeps SQLite and the objects in one folder, with its own accounts and tokens. It's licensed AGPL-3.0, and the source is at upstream.codes/coline/onset.

Get it

onset-server is inside the Linux downloads, next to on. Download the .tar.gz for your machine from the downloads page and unpack it. The install script installs only on.

Run it

onset-server user add alice --name Alice --email alice@example.com --data ./data   # prints a token
onset-server serve --data ./data --listen 0.0.0.0:8790

Put it behind HTTPS. on talks plain HTTP only to localhost, or with ONSET_INSECURE=1.

Without --listen it answers on 127.0.0.1:8899, and without --data it uses ./onset-data.

Use it

Sign in from any machine with the token, then publish or get a project:

on login your.host:8790 --token <token>
on publish your.host:8790/alice/shop
on get your.host:8790/alice/shop

People and projects

onset-server project add alice/shop --owner alice --data ./data        # add --public for an open project
onset-server member add alice/shop sam --role member --data ./data     # owner, member or reader

Git

onset-server has no Git view of its own. For a Git copy on GitHub, GitLab or your own Git server, run a mirror next to it:

on git mirror https://github.com/acme/shop

See Git and GitHub.