Documentation

Everything you need to get around your box. Don’t have an account yet? 👉 Sign up first.

Logging in

ssh -p 2222 <user>@mbox.blue

You’ll land straight inside your own box as root (of your container — you can’t touch anyone else’s). Your home directory is /root.

Persistence

Your box keeps running between logins. Disconnect whenever you like and SSH back in later — your files and any background processes are still there.

💡 To keep interactive programs running across disconnects, use tmux: start it with tmux, detach with ^b d (CTRL + b, then d), and re-attach next time with tmux attach.

Re-entering your box

Re-entering is just logging back in:

ssh -p 2222 <user>@mbox.blue

You can also be explicit:

ssh -p 2222 <user>@mbox.blue attach

Depending on your SSH client you may see the input device is not a TTY, in which case pass -t to force a terminal:

ssh -t -p 2222 <user>@mbox.blue attach

Running one-off commands

You can run a command without opening an interactive shell:

ssh -p 2222 <user>@mbox.blue uptime

The command runs directly (no extra shell), so if you want pipes or redirection, wrap it yourself:

ssh -p 2222 <user>@mbox.blue sh -c 'ls -la | head'

Your web presence

A static page — anything in ~/public_html is served at https://mbox.blue/~<you>:

mkdir -p ~/public_html
echo '<h1>hello from my box</h1>' > ~/public_html/index.html

A web app — run a server on a port inside your box, then tell mbox.blue which port to publish, and it’s served at https://<you>.mbox.blue (with HTTPS handled for you):

# e.g. a quick static server on :8080
cd ~/public_html && python3 -m http.server 8080 &

# publish port 8080
mkdir -p ~/.mbox && echo 8080 > ~/.mbox/expose

Your app appears at https://<you>.mbox.blue within a few minutes (or right away on your next login). Remove ~/.mbox/expose to unpublish. Use tmux to keep your server running after you disconnect.

Resetting your box

To get a fresh box (for example to pick up a newer image), destroy the current one and then log back in:

ssh -p 2222 <user>@mbox.blue destroy
ssh -p 2222 <user>@mbox.blue

Lifecycle commands

Special words you can pass when logging in to manage your box:

• status — report whether your box is running.
• attach — (re)enter your box with a shell (the default when you log in).
• destroy — tear your box down; a fresh one is created on next login.

💡 Most commands can be shortened to their first letter, e.g. s for status. A periodic reaper cleans up any stopped boxes every few minutes.