rembox

Remote dev boxes,
set up securely

rembox turns a fresh Ubuntu server into a secure remote development machine, and helps you manage it from your Mac.

Run this on your Mac (or a Linux machine) to install rembox:

curl -fsSL https://rembox.aakashns.com/install.sh | sh

Early days. So far rembox installs, upgrades and removes itself. Setting up servers comes next, and this page will document each step as it lands.

Commands

rembox help [command]
Lists the commands, or explains one of them.
rembox version
Prints the version, and the commit it was built from.
rembox upgrade [--yes]
Replaces rembox with the latest release, after showing both versions and asking first. Pass --yes to skip the question, e.g. in a script.
rembox implode [--yes] [--backup | --no-backup]
Removes rembox and its files in ~/.config/rembox from this machine, after listing them and asking first. Offers to back the files up to your home folder before deleting them. Servers set up with rembox aren’t changed.

Installing

Run the install command again to reinstall or upgrade. Two environment variables change what it does:

REMBOX_VERSION
Installs this version, like 0.1.0, instead of the latest.
REMBOX_INSTALL_DIR
Installs in this folder instead of /usr/local/bin.
curl -fsSL https://rembox.aakashns.com/install.sh \
  | REMBOX_VERSION=0.1.0 sh

Releases have a binary for macOS and Linux, on both Apple Silicon/ARM and Intel/AMD processors.

Upgrading and uninstalling

rembox upgrade installs the latest release in place of the one you ran. If it’s in a folder only root can write to, as /usr/local/bin often is, run it with sudo. rembox implode uninstalls rembox, and asks for sudo itself if it needs it: 

sudo rembox upgrade
rembox implode

Verifying a release

Every release is built by GitHub Actions from the main branch, with a SHA256SUMS file that both the install script and rembox upgrade check downloads against. Each binary also has a signed build attestation, which you can check with the GitHub CLI: 

gh attestation verify "$(command -v rembox)" --repo aakashns/rembox