Terminus

Appearance

Getting Started on Mac ​

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

NOTE

Currently, Terminus on Mac has certain limitations including::

  • Lack of distributed storage support
  • Inability to add local nodes

We recommend using it only for development or testing purposes.

Prerequisites ​

Before you begin, ensure your system meets these requirements:

TIP

For MiniKube, it's recommended to install via homebrew.

  • TermiPass mobile app installed on your smartphone.

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. In Docker Desktop, navigate to Settings > Resources, and configure as below:

    • CPU limit: Set to at least 4 CPUs
    • Memory limit: Set to at least 9 GB

  2. Click Apply & Restart to implement the changes.

  3. In terminal, navigate to the directory where you want to install Terminus OS, run the following command to start installing:

    bash
    curl -fsSL https://terminus.sh |  bash -

  4. 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 Mac.

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 ​