Catalog¶
The catalog is fixed and read-only: a small set of server types and images. Server types and images can be referenced by name or numeric id (the CLI sends ids).
Manage the local image files with the CLI:
cloudalone image list # what's in the catalog and whether it's downloaded
cloudalone image pull debian-13 # download a base cloud image (or `all`)
Server types¶
| id | name | vCPU | Memory | Disk |
|---|---|---|---|---|
| 1 | small |
1 | 2 GB | 20 GB |
| 2 | medium |
2 | 4 GB | 40 GB |
| 3 | large |
4 | 8 GB | 80 GB |
All are shared-vCPU, x86 architecture. Memory and vCPU map straight onto the libvirt domain; disk is the qcow2 overlay's virtual size.
Images¶
| id | name | Base |
|---|---|---|
| 1 | debian-13 |
Debian 13 cloud image |
| 2 | ubuntu-24.04 |
Ubuntu 24.04 cloud image |
Images are standard cloud images booted with cloud-init. Your SSH key is installed for root (cloud-init disable_root: false), matching Hetzner.
Locations & datacenters¶
A single fixed location and datacenter are exposed so the CLI's --datacenter / location plumbing works. They're cosmetic; there's one host.
Extending¶
Adding a server type or image means editing src/cloudalone/catalog.py (and, for a new image, making sure cloudalone image pull knows its URL). More images and types are a post-0.1 item.