Overview#

This guide provides step-by-step instructions for users of the Gritiva panel to create their first Virtual Machine (VM). It is designed for those who have never installed the Gritiva agent before and need a straightforward approach to get started.

Prerequisites#

Before you begin, ensure you have the following:

• A Linux VM with SSH access (root or sudo privileges) and a kernel version of 5.15 or higher.
• A hosting provider such as Hetzner, AWS, DigitalOcean, or a bare-metal server at home.

Supported Platforms#

This guide supports any Linux distribution that meets the kernel requirement mentioned above.

Step-by-Step Guide#

Step 1: Accessing the VM Tool#

1. In the Gritiva panel, click on 'Add VM' located at the top-right corner.
2. Enter a name for your VM (e.g., prod-eu-1).

Step 2: Configuring VM Settings#

1. After naming your VM, a modal will display the installation command.
2. Copy the following command:

   curl -fsSL https://get.gritiva.com/agent | sudo bash -s -- --token <YOUR_TOKEN>

Step 3: Launching the VM#

1. Open your VM's terminal and paste the copied command.
2. Wait approximately 60 seconds for the installation to complete.
3. Refresh the Gritiva panel; your VM should now appear as 'Online' (indicated by a green dot).

Common Issues#

If your VM does not appear online after 5 minutes, check the agent's status by running:

sudo systemctl status gritiva-agent

If you encounter 'enrollment failed: token expired', generate a new token and repeat the installation steps.

Conclusion#

Congratulations! You have successfully created your first VM and installed the Gritiva agent. Next, consider creating your first scope, attaching a domain, or joining a mesh. For further reading, refer to the following documentation:

• Creating a Scope
• Attaching a Domain
• Joining a Mesh