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

# Desktop background

> Put your own PNG image on the sandbox desktop.

## Set your own background

1. Put a PNG file at `~/.config/boat/wallpaper.png` on the sandbox.
2. The desktop shows it at once.

The image stays after a stop, a resume and a fork. To go back to the default background, delete the file.

```bash CLI theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
boat scp ./wallpaper.png bx_f7k2q9hd:/home/user/.config/boat/wallpaper.png
```

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl -sS -X POST "$BOAT_API_BASE/sandboxes/bx_f7k2q9hd/commands" \
  -H "Authorization: Bearer $BOAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command":"curl -fsSL -o ~/.config/boat/wallpaper.png https://example.com/wallpaper.png"}'
```

```ts TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
await sandbox.command({
  sandboxId: "bx_f7k2q9hd",
  command: "curl -fsSL -o ~/.config/boat/wallpaper.png https://example.com/wallpaper.png",
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
from boat_sdk.models.command_request import CommandRequest

sandbox.command("bx_f7k2q9hd", CommandRequest(
    command="curl -fsSL -o ~/.config/boat/wallpaper.png https://example.com/wallpaper.png",
))
```

## Image limits

| Limit | Value |
| - | - |
| Format | PNG |
| File size | 16 MiB or less |
| Width or height | 8192 pixels or less |
| Total pixels | 16,777,216 or less (for example 4096x4096) |

The image fills the screen and keeps its aspect ratio. If the file is not a valid PNG, the desktop keeps the default background.


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