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

# Run your first Celesto microVM sandbox

> Install Celesto and run your first isolated microVM sandbox in under five minutes — execute commands, check outputs, and tear it down with a context manager.

By the end of this guide you'll have an isolated Linux sandbox running on your machine, ready to execute commands safely.

**1. Install Celesto**

```bash theme={null}
curl -sSL https://celesto.ai/install.sh | bash
```

This installs everything you need and configures your machine. See [Installation](https://celesto.ai/docs/celesto/installation.md) for manual install and requirements.

**2. Run your first sandbox**

Create `quickstart.py`:

```python quickstart.py theme={null}
from celesto import Celesto

vm = Celesto()
result = vm.run("echo 'Hello from the sandbox!'")
print(result.stdout.strip())
vm.stop()
```

Run it:

```bash theme={null}
python quickstart.py
```

You should see:

```text theme={null}
Hello from the sandbox!
```

> [!NOTE]
>
> The first run takes 30-60 seconds to download the operating system images.

## Prefer the command line?

You can do the same thing without writing any Python:

```bash theme={null}
celesto sandbox create --name my-sandbox
celesto sandbox ssh my-sandbox       # opens a shell inside the sandbox — type `exit` to leave
celesto sandbox stop my-sandbox
```

## Customize resources

Configure memory and disk for heavier workloads (defaults: 512 MiB memory, 512 MiB disk):

```python theme={null}
from celesto import Celesto

vm = Celesto(memory=2048, disk_size=4096)
result = vm.run("free -m")
print(result.stdout)
vm.stop()
```

## Next steps

> [card] [AI agent integration](https://celesto.ai/docs/celesto/guides/ai-agent-integration.md)
>
> Plug Celesto into PydanticAI, OpenAI Agents, LangChain, and more

> [card] [Port forwarding](https://celesto.ai/docs/celesto/features/port-forwarding.md)
>
> Expose services running inside a sandbox to your host machine

> [card] [Custom images](https://celesto.ai/docs/celesto/guides/custom-images.md)
>
> Build specialized images with your own tools pre-installed

> [card] [API reference](https://celesto.ai/docs/celesto/api/celesto.md)
>
> Explore the complete Celesto API

> [!TIP]
>
> Join the [Discord community](https://discord.gg/KNb5UkrAmm) to get help and share your use cases.


## Related topics

- [Celesto: secure microVM sandboxes for AI agents](https://celesto.ai/docs/celesto/introduction.md)
- [Windows sandboxes in Celesto](https://celesto.ai/docs/celesto/guides/windows-guests.md)
- [Celesto architecture overview](https://celesto.ai/docs/celesto/concepts/overview.md)
- [Run Docker in a Celesto sandbox](https://celesto.ai/docs/celesto/features/docker.md)
- [celesto sandbox exec](https://celesto.ai/docs/celesto/cli/exec.md)


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