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.
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
- Open Images
Go to Compute > Images to browse the images you can see.
Screenshot — The Images list with visibility tabsThe Images list with visibility tabs - 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.
- 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 fieldsThe image upload dialog with the file and format fields - 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 imageThe visibility and protection controls on an image - Launch or download
Launch a new instance from any image you can see, or download an image you own.
Examples
curl -H "Authorization: Bearer $TOKEN" \ https://api.patrii.cloud/images
curl -H "Authorization: Bearer $TOKEN" \ https://api.patrii.cloud/images/my-snapshots
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:
| Action | What it does |
|---|---|
Upload | Add your own disk file as a private image. |
Create image | Capture a server into a reusable image. |
Share | Make a private image visible to named projects. |
Protect | Block deletion until protection is turned off. |
Download | Retrieve an image file you own. |
Delete | Remove 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?
Why can't I delete an image?
Who can see my uploaded image?
Learn more
Everything you can do here in the console is also available through the Patrii Cloud API for automation and scripting.