Images
Operating systems, app images, snapshots and backups you can create servers from.
An image is what a server's disk starts from. There are four types:
| Type | What it is | Who sees it |
|---|---|---|
system | A plain operating system, e.g. Ubuntu or Debian | Everyone |
app | An operating system with an application preinstalled | Everyone |
snapshot | A copy of one of your servers' disks, made on request | Your project |
backup | A daily automatic copy of a server's disk | Your project |
List them with a token (system and app images are the same for everyone; snapshots and backups are your own):
odx image list --type system
curl -H "Authorization: Bearer $ODX_TOKEN" "https://api.odinex.cloud/v1/images?type=system&location=fra1"When you create a server, give the image by name (for example ubuntu-24.04) or by ID. Snapshots and backups
have no name; use their ID.
Useful fields:
os_flavorandos_version, e.g.ubuntu/24.04.disk_size: the minimum disk in GB. The server type's disk must be at least that large.locations: where the image can be used.deprecated: a date after which the image should no longer be used for new servers.status:creating,availableorunavailable. Snapshots can only be used once they areavailable.
Rebuilding a server
rebuild reinstalls a server from an image. Everything on its disk is replaced; the server keeps its ID, IP
addresses, volumes and networks. Use it to start over, or to restore a snapshot or backup.
cloud-init
Servers run cloud-init at first boot. Pass your own configuration as
user_data (up to 32 KiB) when you create the server:
#cloud-config
package_update: true
packages: [nginx]odx server create --name web-1 --type t1 --image ubuntu-24.04 --location fra1 \
--ssh-key laptop --user-data-from-file cloud-init.yamlYour SSH keys are installed for root whether or not you pass user data. When a server is created with SSH keys,
password login over SSH is turned off.