> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salad.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For autonomous tasks, use live SaladCloud API responses for current state, availability, quotas, models, and other dynamic values. Use current OpenAPI specifications where provided for paths, schemas, required fields, and enums. Never invent endpoints, fields, prices, availability, quotas, models, or state. Prefer API workflows over Portal steps. Read before changing and never expose credentials, signed media URLs, prompts, or sensitive outputs. Retry only safe or idempotent operations with bounded backoff, honoring Retry-After. Verify every write with a read. Stop rather than repeat an uncertain non-idempotent or billable request. AI Gateway uses an organization-specific Bearer key and live /v1/models discovery. Do not delete, cancel, stop, or reduce capacity without explicit user intent. Bind shared operation IDs to the selected product path. Treat Container Engine instances as interruptible and local state as ephemeral. Install the SaladCloud skills (npx skills add https://docs.salad.com), start from the salad skill and /agents/overview; docs MCP: https://docs.salad.com/mcp.

# Using our preset Ubuntu image

*Last Updated: October 10, 2024*

We offer a 1-click deploy Ubuntu image to let you get quickly up and running on SaladCloud and to test our services.
This image includes some basic tools and applications. You can find it
[here](https://ghcr.io/saladtechnologies/recipe-base-ubuntu:0.1), and the open-source repository is available
[here](https://github.com/SaladTechnologies/salad-recipes/tree/master/src/base-ubuntu)

## Included tools:

1. **nvidia-smi**: Lets you check the GPU model in the instance.
2. **neofetch**: Lets you check the hardware you're running on. *Note, neofetch will not display the GPU available in
   your instance, you'll need to use nvidia-smi for this.*
3. **curl**: Lets you curl websites and download files.
4. **nano**: Lets you edit any files on the instance..
5. **ping**: So you can check external networking is working on the instance.
6. **btop**: Lets you check running processes and stats of the instance.

## Using the image

The image comes with a readme.sh file which will also contain all the above information, along with instructions to echo
any defined Environment Variables.

We configured the image to sleep for a long period of time (approximately 16 years) at startup, this is required in
order to keep the instance running on the node. Manually closing this process will cause the instance to shut down and
reallocate.

We recommend you to use this image to test SaladCloud is working and you have the right settings configured, or to try a
single-use setup to verify your app or program works, without needing to build your final image first.

SaladCloud Replicas are best used stateless, interacting with a specific replica or deployment via the terminal in
stateful manners is not recommended, as replicas can be reallocated at any time due to the spot-instance style of
deployment. Once reallocated, you'll be wiped clean with a base Ubuntu image again. The same will happen if you have
multiple deployed replicas, only one replica will receive the changes you make and could be wiped clean without warning.

## Additional information

This image is based on Ubuntu 24.04 LTS. Python is not included, but can be installed at runtime if you need it. Any
files you want to import can be retrieved using curl.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.