Setup

Runox - the new version in Rust

Packaging for all platforms takes some time and is not trivial outside the GitHub Actions ecosystem. Only Linux builds are provided for now. Windows and MacOS builds will hopefully be created this summer 2026.

Prerequisites

You need to have Docker running to test containers !

Install the package

Go download one of the binary from the latest release on Codeberg

Fedora and family

sudo rpm -i ./runox_*.rpm

Ubuntu and family

sudo dpkg -i ./runox_*.deb

Arch Linux and family

sudo pacman -U ./runox_*.pkg.tar.zst

Alpine

sudo apk add --allow-untrusted ./runox_*.apk

Check the installation

You should have the runox command available and the Runox server should be available.

> runox --version
runox 0.0.1
> ls /usr/share/runox
runox-cli-linux-static

Install scr.fish

scr is a way to quickly create scratch projects. This is very useful to test Runox on various languages without creating tons of files manually.

Make sure you have the latest version of scr.fish Help: I don't have lxup !

lxup get scr
# restart terminal
scr -v # should give at least v17

If this is the first you are using it, you can quickly setup scr with the following commands. You need to configure a scratchs folder and your preferred editor. For demo purpose, you can just use cat to see the content of the entry file, instead of opening it.

mkdir -p ~/.scratchs
set -g SCR_TMP_FOLDER ~/.scratchs
set -g SCR_EDITOR cat

You can put the last two lines into ~/.config/fish/config.fish if you want them to be persisted. Otherwise, you'll need to type them again on the next shell restart.

To validate scr is working, type scr, you should get a list of templates. Pick one (like c) and you'll be jumped into a new folder with a main.c present.

Setup a shorter alias

Instead of typing runox, you can define an alias to type ru (or even r if you don't have r.fish or you are okay masking it)

# For Fish
alias ru runox
# For bash/zsh
alias ru=runox

Older version of Runox written in Fish (r.fish)

This version support a broader range of tools, so it is still useful. We'll gradually replaced it with the new Rust version.

You can get and its required dependencies with Help: I don't have lxup !

lxup play base

You'll get the r command.