Quickstart Guide

Step 1. Access the Management Console

Open the microsrv Console. After signing in, you will be automatically routed to your default project workspace.

Step 2. Add Your Public SSH Key

For secure authentication without passwords, add your public SSH key to your project:

1. Navigate to SSH Keys (/console/ssh-keys).
2. Click Add SSH Key.
3. Enter a friendly label (e.g., workstation-ed25519) and paste your public key string (from ~/.ssh/id_ed25519.pub).

Step 3. Launch a Virtual Machine

1. Open Virtual Machines (/console/vms) and click Create VM.
2. Configure the essential fields:
   • VM Name: enter a hostname identifier (e.g., demo-web).
   • Resource Preset: choose a compute spec (e.g., 2 vCPU / 4 GB RAM / 30 GB NVMe).
   • Private Network (VPC): select your project’s default-vpc.
   • SSH Keys: check the SSH key added in the previous step.
3. Click Launch VM. Provisioning and block volume initialization complete in under 30 seconds.

Step 4. Connect via SSH Gateway

Once the VM state shifts to Running, connect directly via the SSH proxy gateway without provisioning a public IP:

microsrv:~$ ssh -A demo-web@msrv.space

[!TIP] The -A flag enables SSH Agent Forwarding, allowing you to authenticate safely using your local key agent without storing private credentials on remote servers.

Upon connection, you will see the system welcome prompt:

microsrv: connection to demo-web established
Welcome to Ubuntu 24.04 LTS (GNU/Linux 6.8.0 x86_64)

System information: 2 vCPU · 4 GB RAM · 30 GB SSD
Private VPC Address: 10.42.0.12

ubuntu@demo-web:~$

Step 5. Verify Outbound Connectivity & Run a Service

Verify that Outbound NAT is functioning properly and start a simple web server:

# Verify outbound access to external APIs
ubuntu@demo-web:~$ curl -s https://api.github.com | head -n 5

# Start a simple HTTP server
ubuntu@demo-web:~$ echo "Hello from microsrv!" > index.html
ubuntu@demo-web:~$ python3 -m http.server 8080

[!IMPORTANT] To publish a service on the internet, see the HTTPS gateway guide.