Launch your first VM
This quickstart gives you a working Linux server in the IBEE cloud: you create a small Ubuntu VM, connect to it over SSH from your own computer, put a test web page on it, and then delete it so it stops costing money. Every step uses the defaults, so you don’t need to know anything about networks or firewalls yet.
When to use this page
How it works
- You create an SSH key: a pair of files on your computer. The public half goes on the VM; the private half stays with you and acts as your password.
- You create the VM in the portal (or with one CLI command) and add the public key to it.
- You connect with
ssh ubuntu@<the VM's IP address>. - You delete the VM. Billing stops when it’s gone.
Before you begin
-
An IBEE account with a verified identity, and an organization.
-
Write access to a workspace.
-
Credit in your wallet. The Deploy page shows the exact hourly and monthly price before you click Deploy. See Billing and usage.
-
A terminal: Terminal on macOS or Linux, or PowerShell on Windows 10 and later (both include
ssh). -
An SSH key. If you don’t have one, create it now and press Enter to accept the defaults:
This creates
~/.ssh/id_ed25519(private, never share it) and~/.ssh/id_ed25519.pub(public). Print the public key withcat ~/.ssh/id_ed25519.pub.
Option A: the portal
Pick a small plan
Under Choose Plan, pick perf.1.c2.m4: 2 vCPU, 4 GiB of memory, a 50 GB disk and 2 TB of outbound data per month. That’s enough for a test website or API. The price per hour and per month updates as you choose. Other sizes are listed in Instance types.
Pick Ubuntu
Under Operating System → Templates, click Ubuntu, then choose Ubuntu 24.04 (or the newest version listed) from OS Version.
Add your SSH key
Under SSH Keys, click Add Key, open Import Key, give the key a name and paste the contents of ~/.ssh/id_ed25519.pub. If you’ve saved the key before, pick it from Select SSH Keys instead.
Keep the defaults
Leave Network Configuration on Public IP with No VPC · public interface only, leave Firewall empty (the default firewall group allows SSH on port 22 and web traffic on ports 80 and 443), and leave Billing on Hourly.
Name it and deploy
Under VM Details, keep Instances at 1 and enter a hostname such as web-01 (lowercase letters, numbers and hyphens). Click Deploy. You return to the Cloud Virtual Machines list, where the VM shows Provisioning. If a Billing needs attention popup appears instead, click Add Credits, top up and deploy again.
Option B: the ibee CLI
The CLI needs Python 3.10 or later.
Install the CLI and sign in
Create an API token under Organization → API Tokens with the vm.read and vm.write scopes. Find your workspace ID in the portal URL (.../workspaces/710995/...). Then:
Find a site, a plan and an image
Note the site_id for Amaravati, the plan_id of perf.1.c2.m4, and the template_id of an Ubuntu image.
Create the VM
Pass those IDs, the plan’s size (2 vCPU, 4096 MB of memory, a 50 GB disk) and the image’s OS. --billing-interval HOURLY makes the CLI read the plan and send its hourly billing selection, as the portal does:
The command prints an operation_id straight away, while the VM is created in the background. Check it until status is succeeded (or failed), then list your VMs to see the new VM’s ID and public IP:
Verify
From your computer, check that the server answers:
Then, signed in to the VM, install a web server:
The last command prints HTTP/1.1 200 OK. Open http://203.0.113.10 (your VM’s address) in a browser to see the “Welcome to nginx!” page. Port 80 is open in the default firewall group, so no firewall change is needed.
Clean up
A VM is billed every hour until you delete it. Stopping it is not enough: a stopped VM is billed at the same rate.
The VM disappears from the list when deletion finishes, and billing stops.
What it costs
Troubleshooting
Next steps
- Back up your VM, or take a snapshot before risky changes.
- Open more ports for your app.
- Attach a Block Storage volume for data that should outlive the VM.
- Resize the VM when you need more power.
- Create a VM: every option on the Deploy page.
