Skip to content

Beta: these docs are still being updated. The next full update is on 18 November at 8 PM UTC. Docs in beta. Full update 18 Nov, 8 PM UTC.

Hoody.com

Every computer starts from an image: the operating system, pre-installed software and default configuration it boots with. The platform carries one base image, Debian 13 (debian/13). The marketplace lists images too, both free community images and paid images that arrive pre-configured.

Name the image in computer_image when you create a computer:

POST Create computer with specific image
/api/v1/projects/{project_id}/computers
Click "Run" to execute the request

The format is {os}/{release}. A create accepts only debian/13 (the shorthands debian and debian-13 resolve to it), and uses debian/13 when computer_image is omitted or null. Naming an unsupported image returns 400. Use debian/13. That holds whatever your image library holds.

In the Hub, open Computers and choose Get a computer. A new computer starts from Debian 13; the form shows System as Debian 13, with no other image choice.

Computer Image (Debian 13)
↓
Computer Creation
↓
Running Computer (Debian 13 + your work)

An image provides the base operating system (a Linux distribution), system libraries and tools, the default package manager (apt), the initial filesystem structure and sometimes pre-installed software such as databases, web servers or dev tools. Your work builds on top: install applications, configure services, add data and change the environment.

  • Images are immutable templates. Creating a computer from an image does not change the image. A computer’s image is fixed once the computer exists; to start again from a clean base, see Change the OS.
  • Images do not include the Hoody Kit. Its 20 HTTP services are installed when you create the computer with hoody_kit: true.

Search the public marketplace by keyword. A search matches the image’s alias, name and description:

Terminal window
# Find Docker-related images
hoody images list --search docker
# Find database images
hoody images list --search database
# Find Node.js images
hoody images list --search nodejs

Narrow the list by operating system, CPU architecture, price or rating, sort it and page through it with the marketplace filters. Each image’s architecture, size, price and ratings are in its image fields.

Your library holds the images you imported or bought. Today a library entry lets you list the image and rate it; a create still starts from debian/13.

Most OS images are free. Import one into your library. With an auth token, importing or rating an image needs the computers.create permission, and listing your library needs computers.read; without it the call answers 403:

POST Import image to your library
/api/v1/images/import/{image_id}
Click "Run" to execute the request

Some images include pre-installed commercial software and carry a price. Check the image details, price included, first:

GET Get image details
/api/v1/images/public/{image_id}
Click "Run" to execute the request

Buying deducts the price from your wallet balance. It is a one-time payment, and the image stays in your library. With an auth token, buying needs the financial.wallet.transfer permission; without it the call answers 403:

POST Purchase premium image
/api/v1/images/purchase/{image_id}
Click "Run" to execute the request

Your library lists the images you have imported or purchased:

GET List your imported/purchased images
/api/v1/images/user
Click "Run" to execute the request

A create still names its base image in the {os}/{release} format, debian/13, whatever your library holds. The responses and refusals are in the reference.

Rate images honestly on the 0 to 5 scale. Ratings are what the next person sees when picking an image. You can rate an image in your library (import a free one first) with a whole number, and rating again replaces your earlier rating:

POST Rate an image
/api/v1/images/rate/{image_id}
Click "Run" to execute the request

What each number means: the rating scale.

Run Docker or Kubernetes inside a computer

Section titled “Run Docker or Kubernetes inside a computer”

Hoody computers support Docker, Kubernetes and other container orchestration platforms. A computer created with hoody_kit: true gets the dev kit by default, and the dev kit already includes Docker Engine, Docker Compose and Docker Buildx.

Nothing to install and nothing to start: the Docker daemon starts on the first docker command, and the default user can run docker without sudo.

Terminal window
# In a computer created with hoody_kit (dev kit on by default)
docker run hello-world
docker compose up -d
docker build -t myapp .

In a computer without the dev kit, install Docker Engine by following Docker’s installation guide for Debian and check that Docker is running. Run Docker commands with sudo, for example sudo docker run hello-world. To run them without sudo, follow Docker’s post-installation steps for non-root users and start a new login session. What works: Docker hosts.

Kind, Minikube and K3s each run a full Kubernetes cluster inside a Hoody computer, and Podman runs too. Each needs a short setup: Kubernetes and Podman.

You cannot create your own custom images through the API. Images and snapshots together get close, giving you reusable environment templates:

Start with a clean computer from the debian/13 image, with Hoody Kit enabled.

In the Hub, open Computers, pick the configured computer and open its Backups tab. Choose Take snapshot, enter a Name and press Take snapshot; Delete after (days) is optional. To start a new computer from it, choose New computer from this on the snapshot’s row, then Make the computer.

  • CPU architectures: an image’s architecture field shows which CPU it targets. A computer from debian/13 gets its server’s architecture automatically, so there is nothing to match.
  • Image variants: an image’s variant field names its configuration; for debian/13 it is default. You still name the image by its alias.
  • Image icons: download an image’s icon with GET /api/v1/images/{id}/icon. An image without an icon returns a generic placeholder PNG.
  • Cost of an image: computers are not charged separately. A premium marketplace image has its listed purchase price.
  • Windows computers: Every computer starts from debian/13. To run Windows inside a computer with KVM enabled, use Hoody VM.

Fields, filters, architectures, ratings, Kubernetes setup, practices and troubleshooting: the Computer Images reference. Every call and status: the Computer Images API.