2.9 KiB

Raw Permalink Blame History

xrsh

click here for the website / hosted repo

XRSH Manual

Documentation for XRSH users can be found here

TIP: this is also available by typing ctrl/cmd+a+0 or man xrsh inside XRSH

Wiki / Roadmap

See the wiki here

Install

NOTE: installation is optional: just surf to the public version here

install using nix

NIX is a convenient way to install or develop xrsh:

run nix-run -p xrsh --run "xrsh.com" (pass -p XXXX to specify non-default 8080 port )
build it when package does not exist: nix-build -E "with import <nixpkgs> { }; callPackage ./xrsh.nix"

install without nix

Download xrsh.com
optional: run unzip xrsh.com to verify repository contents
run chmod +x xrsh.com in your console (only linux/mac)
run ./xrsh.com in (any) shell
Profit! ✔

launch different .iso / modify files

You can specify a different .iso file in various ways:

open the xrsh.com as a zip (drag-drop into a zip-manager, or add .zip extension)
method 1: overwrite xrsh.iso
method 2: open src/index.html and change isoterminal="iso: ./../xrsh.iso" to another file/URL

see developer-section below on building your own iso

The browser auto-launches https://localhost:8080 on most platforms

pass -p XXXX to specify port (default:8080)

Developers

Make sure to clone the repo including submodules (the xrsh-com repo)

$ git clone --recurse-submodules https://forgejo.isvery.ninja/xrsh/xrsh
$ cd xrsh
$ nix-shell  # optional but adviced (to get up and running instantly)

Now serve the repo from a HTTPS webserver (for example run ./make dev)

Run ./make standalone to package everything into xrsh.com

development of components (src/com) takes places in this git submodule
development of xrsh.iso takes places in this gitsubmodule

Funding

This project is funded through NGI0 Entrust, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program. Learn more at the NLnet project page.

2.9 KiB Raw Permalink Blame History