hello world: Urbit edition

Install, boot, and run your Urbit planet on a $10 cloud server

Photo by SpaceX on Unsplash

Updated for the latest Urbit release: v0.10.7

Urbit planet user guides

Create a Digital Ocean droplet

Select these options:

Install, boot, and disconnect

Step 0: Connect to the droplet

ssh root@<droplet ip address> 

Step 1: Configure the droplet and install Urbit

sudo apt-get update
mkdir temp
curl -o temp/archive.tgz -O https://bootstrap.urbit.org/urbit-v0.10.7-linux64.tgz
tar xzf temp/archive.tgz -C temp/
rm temp/archive.tgz
chown -R root:root temp/urbit-v0.10.7-linux64/
mv temp/urbit-v0.10.7-linux64/* ./
rm -rf temp/
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
sudo cp /etc/fstab /etc/fstab.bak
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Step 2: Upload your keyfile to the droplet

scp <local path to keyfile> root@<droplet ip address>:

Step 3: Boot your planet

./urbit -w <planet name> -k <keyfile>

Step 4: Mount the filesystem

|mount %

Step 5: Shut down your planet

ctrl-d

Step 6: Securely delete your keyfile

shred -vzn 3 <keyfile>rm <keyfile>

Step 7: Disconnect from your droplet

exit

Create a screen and re-start your planet

Step 0: Connect to your droplet

ssh root@<droplet ip address>

Step 1: Create a screen

screen -S <name of the screen>

Step 2: Re-start your planet

./urbit <planet name>

Step 3: Detach from the screen

ctrl-a d

Step 4: Disconnect from your droplet

exit

Say hi to ~dopzod

Step 0: Connect to your droplet

ssh root@<droplet ip address>

Step 1: Re-attach to the screen

screen -r <name of the screen>

Step 2: Say hi

|hi ~dopzod
# Successful response:

hi ~dopzod successful
; ~dopzod is your neighbor

Step 3: Detach from the screen and disconnect from your droplet

ctrl-a dexit

Generate a passcode and access Landscape

Step 0: Connect and re-attach

ssh root@<droplet ip address>screen -r <name of the screen>

Step 1: Generate a passcode

+code

Step 2: Login to Landscape

Step 3: Detach and disconnect

ctrl-a dexit

A to Z: boot, run, and administer ~magmyr-darlex

On a droplet with IP address 123.45.67.890

# CONNECT TO THE DROPLETssh root@123.45.67.890
# CONFIGURE THE DROPLET & INSTALL URBIT
sudo apt-get update
mkdir temp
curl -o temp/archive.tgz -O https://bootstrap.urbit.org/urbit-v0.10.7-linux64.tgz
tar xzf temp/archive.tgz -C temp/
rm temp/archive.tgz
chown -R root:root temp/urbit-v0.10.7-linux64/
mv temp/urbit-v0.10.7-linux64/* ./
rm -rf temp/
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
sudo cp /etc/fstab /etc/fstab.bak
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# UPLOAD KEYFILE **run this command on your local machine**
scp ~/Downloads/magmyr-darlex.key root@123.45.67.890:
# BOOT THE PLANET
./urbit -w magmyr-darlex -k magmyr-darlex.key
# MOUNT THE FILESYSTEM
|mount %
# SHUT DOWN THE PLANET & DELETE KEYFILE
ctrl-d
shred -vzn 3 magmyr-darlex.key
rm magmyr-darlex.key

# CREATE SCREEN
screen -S urbit-planet
# RE-START THE PLANET
./urbit magmyr-darlex
# GENERATE LANDSCAPE PASSCODE
+code
# DETACH & DISCONNECT
ctrl-a d
exit

Urbit frontiersmen hellbent on improving the digital experience. Creators of Urbit’s largest planet exchange and first network explorer. https://urbit.live

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store