interestingsoup/urbit-aarch64 repository overview

⁠urbit-aarch64

Dockerfile for Urbit on Aarch64. Built image is derived from Urbit on ARM⁠.

⁠Usage

To start a new urbit with a pier called mycomet:

$ docker run -ti interestingsoup/urbit-aarch64  -c mycomet

Don't forget -t and -i or urbit will shut down immediately due to the lack of an attached TTY.

⁠HTTP access

The image exposes the urbit's http server at port 80. Publishing that port Will allow you to see your urbit's hosted content at localhost:80:

$ docker run -ti -p 80:80 interestingsoup/urbit-aarch64 urbit -c mycomet

The image also expose urbit's ames server at 34343.

⁠Binding data to the host FS

The container's working directory is /urbit, and all data is stored there, so if you want to keep your data, you'll want to mount your urbit from the local filesystem. For example, to create a comet in a directory mycomet:

$ docker run --rm \
    --volume `pwd`:/urbit \
    -ti interestingsoup/urbit-aarch64 \
    -c mycomet

You will most certainly want to access this data with a non-root account, but urbit is running as root inside this container (for a few good reasons). To ensure that you can access the files and directories created by urbit, run the container with the --user option set to your user and group id:

$ docker run --rm \
    --volume `pwd`:/urbit \
    --user `id -u`:`id -g` \
    -ti interestingsoup/urbit-aarch64 \
    -c mycomet

Currently you need to mount the whole /urbit when creating a new urbit, because if you mount to /urbit/mycomet, docker will initialize that directory and vere wont start if it exists (even though it will be empty).

If you're booting an existing urbit however, you'll want to mount only the pier into /urbit/<name>. For example, to launch an existing urbit fintud-macrep:

$ docker run \
    --volume `pwd`/fintud-macrep:/urbit/fintud-macrep \
    -ti paulbellamy/urbit \
    mycomet

Note there is no -c examples above, most likely you will want to run a container with -c in the beginning, then start another, permanent one to keep it running without it.

⁠More Info

For more info on usage, please see the urbit setup docs⁠.

##Questions Urbit group: 🧠🥣InterestingSoup⁠ Urbit DM: ~togtun-pocres Website: https://interestingsoup.com⁠ TikTok?! Why Not! :@interestingsoup

⁠Special thanks to:

asssaf⁠ paulbellamy⁠ ~mopfel-winrux⁠ ~siteful-hatred⁠