| name | sandboxes-cli |
| description | Manage Koyeb sandboxes: create, list, run commands, manage processes, filesystem operations, and port exposure using the CLI. |
| license | MIT |
| compatibility | Requires the Koyeb CLI and network access. |
| metadata | null |
| author | koyeb |
| version | 0.0.2 |
Koyeb Sandboxes (CLI)
When to use
Use this skill to interact with Koyeb sandboxes created via koyeb service create --type=sandbox, including running commands, managing processes, files, and ports.
Prerequisites
- Koyeb CLI installed and on PATH
- Authenticated session (see references/koyeb-auth.md)
Workflow
- Create or identify a sandbox.
- Check health and list running processes.
- Run commands or start background processes.
- Expose or unexpose ports as needed.
- Use filesystem commands for data inspection.
Commands
- Create sandbox:
koyeb sandbox create SANDBOXNAME --app APPNAME [flags]
- List sandboxes:
koyeb sandbox list SANDBOXNAME/APPNAME[flags]
- Check health:
koyeb sandbox health SANDBOXNAME/APPNAME [flags]
- Run command:
koyeb sandbox run SANDBOXNAME/APPNAME -- <command> [args...]
- Start process:
koyeb sandbox start SANDBOXNAME/APPNAME -- <command> [args...]
- List processes:
koyeb sandbox ps SANDBOXNAME/APPNAME [flags]
- Kill process:
koyeb sandbox kill SANDBOXNAME/APPNAME <pid> [flags]
- Stream logs:
koyeb sandbox logs SANDBOXNAME/APPNAME <pid> [flags]
- Filesystem operations:
koyeb sandbox fs SANDBOXNAME/APPNAME <subcommand> [flags]
- Expose port:
koyeb sandbox expose-port SANDBOXNAME/APPNAME <port> [flags]
- Unexpose port:
koyeb sandbox unexpose-port SANDBOXNAME/APPNAME [flags]
Examples
- Create a sandbox:
koyeb sandbox create --name my-sandbox
- Run a command:
koyeb sandbox run SANDBOXNAME/APPNAME -- ls -la
- Start a background process:
koyeb sandbox start SANDBOXNAME/APPNAME -- python app.py
- Expose a port:
koyeb sandbox expose-port SANDBOXNAME/APPNAME 8080
References
For detailed flags, see references/koyeb-sandbox-flags.md.
- references/koyeb-cli.md
- references/koyeb-sandbox-flags.md
- references/koyeb-auth.md
- references/koyeb-output.md
