Skip to content

Getting Started on Raspberry Pi

This guide will walk you through the essential steps to get Terminus up and running on your Raspberry Pi. Follow these steps to create your account, install Terminus, and start exploring the Terminus ecosystem.

Prerequisites

Step 1: Create a Terminus Name

Open TermiPass on your mobile, and create a new Terminus Name as instructed on the screen.

INFO

Terminus Name is your unique identifier within Terminus. Learn more about why you need a Terminus Name.

Step 2: Install Terminus

  1. Configure the Raspbian environment to enable necessary features:

    bash
    echo "$(head -1 /boot/firmware/cmdline.txt) cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1" | sudo tee /boot/firmware/cmdline.txt
    
    echo "kernel=kernel8.img" | sudo tee -a /boot/firmware/config.txt
  2. Bind your local IP to your Ubuntu hostname for stable DNS resolution:

    bash
    sudo apt install net-tools
    ifconfig
    # Get your local IP. Make sure it starts with `192.168`.
    bash
    sudo nano /etc/hosts
    # Add the following line
    192.168.xx.xx  raspberrypi 
    # Replace with your actual local IP and your host name.
  3. Reboot your Raspberry Pi to apply the changes.

    bash
    sudo reboot
  4. Install the latest build of Terminus:

    bash
    curl -fsSL https://terminus.sh |  bash -
  5. At the end of the installation, take note of the URL for Terminus Activation wizard and your initial login password.

For more detailed instructions, see Install Terminus on Raspberry Pi.

Step 3: Activate Terminus

  1. Open the Terminus Wizard in your browser using the URL and login with your initial password.
  2. Follow the on-screen instructions to complete the initial setups.
  3. Scan the QR code with TermiPass mobile to activate Terminus, and reset your login password.

For complete activation guidance, see the Wizard documentation.

Step 4: Log In to Terminus

On your Wizard page, log in to Terminus with the password you just reset and complete two-step verification on TermiPass. For more information, see the Login documentation.

WARNING

Always Back up your mnemonic phrase to ensure account and data security.

Next Steps