Skip to Content
Open Beta — managed Kubernetes, DNS & more are live.
💿

Images

Updated 2026-11-20
On this page

Images

Images are the operating-system templates your instances boot from. Use Patrii-provided images, upload your own, or capture a running instance as a reusable image.

Every instance boots from an image. Patrii Cloud offers a curated set of public images for common operating systems, and you can add your own by uploading a disk file or by capturing an existing server.

Images have a visibility that decides who can see them: public images are available to everyone, private images belong to your project, and you can share a private image with specific other projects. You can also mark an image as protected so it cannot be deleted by accident.

Screenshot — The Compute > Images page with the public, community, private and shared image tabs
The Compute > Images page with the public, community, private and shared image tabs

Key concepts

Public image — A curated operating-system image available to everyone.

Private image — An image owned by your project, including snapshots you capture.

Shared image — A private image made available to specific other projects you name.

Visibility — Whether an image is public, community, private or shared.

Protection — A flag that blocks deletion of an image until you turn it off.

Before you start

  • Enough image-storage quota in your project to upload or capture.
  • For a capture, a running or stopped instance to snapshot.
  • For sharing, the ID of the project you want to share with.

Step by step

  1. Open Images

    Go to Compute > Images to browse the images you can see.

    Screenshot — The Images list with visibility tabs
    The Images list with visibility tabs
  2. Choose how to add an image
    • Browse public images and launch directly, or
    • Choose Upload to add your own disk file, or
    • Capture a running server with Create image from its actions menu.
  3. Upload a file

    Select your image file and provide its format; the upload is validated against your quota before it starts.

    Screenshot — The image upload dialog with the file and format fields
    The image upload dialog with the file and format fields
  4. Set visibility and protection

    Keep the image private, share it with named projects, and turn on protection if it should not be deletable.

    Screenshot — The visibility and protection controls on an image
    The visibility and protection controls on an image
  5. Launch or download

    Launch a new instance from any image you can see, or download an image you own.

Examples

List images you can see (API)
curl -H "Authorization: Bearer $TOKEN" \
  https://api.patrii.cloud/images
List your own snapshots and private images (API)
curl -H "Authorization: Bearer $TOKEN" \
  https://api.patrii.cloud/images/my-snapshots
Launch from an image with the CLI
patrii server create \
  --name from-image \
  --image my-golden-image \
  --flavor <flavor> \
  --network private-net \
  --key my-key

Limits & specifications

What you can do with an image:

ActionWhat it does
UploadAdd your own disk file as a private image.
Create imageCapture a server into a reusable image.
ShareMake a private image visible to named projects.
ProtectBlock deletion until protection is turned off.
DownloadRetrieve an image file you own.
DeleteRemove an image you no longer need.

Best practices

  • Keep a small set of golden images so new instances start from a known, patched baseline.
  • Protect images you rely on so they cannot be deleted by accident.
  • Name and version your images clearly (for example base-web-2026-01) so the right one is easy to pick.
  • Share images with only the specific projects that need them, not publicly.

FAQ

What's the difference between an image and a snapshot?
A snapshot is an image captured from a running instance. Once captured, it behaves like any other private image you can launch from or share.
Why can't I delete an image?
It is probably protected. Turn off protection from the image's actions, then delete it.
Who can see my uploaded image?
By default only your project. It becomes visible to another project only when you explicitly share it with that project.

Learn more

Everything you can do here in the console is also available through the Patrii Cloud API for automation and scripting.

Was this article helpful?
Thank you for your feedback. Still stuck? Contact us