Manage a managed environment
A managed Project keeps its files in its own machine, which you control from the Project.
Run an environment action
- Open Projects and find the managed Project.
- Open the Actions menu on its card, the button with three dots.
- Choose an action, such as Start environment or Restart environment.
- Watch the progress window until it shows Done or the failure, and use Show log for the detail.
The menu enables only the actions the environment's current state allows. Restoring a snapshot happens on the Project's Environments tab, in its Complete snapshots list.
Accepting the request is not the same as finishing it. Read the final status before you rely on the environment or send work to it.
What you can do
| Action | What it does | Running work |
|---|---|---|
| Start environment | Boots the Project's machine, or prepares it on first use | — |
| Stop environment | Shuts the machine down and keeps files and installed packages | Interrupted |
| Restart environment | Stops and starts it again | Interrupted |
| Create snapshot | Copies the whole environment while execution is paused | Paused |
| Restore snapshot | Replaces the current state with a snapshot, after a confirmation | Interrupted |
A snapshot covers the root filesystem, files, Git worktrees, HOME and data. It is crash-consistent, not a database-consistent backup, so export application databases separately when consistency matters.
Warning: Restoring a snapshot discards everything that changed since it was taken. Check the date in the confirmation before you continue.
A host Project runs in its own folder and a computer Project runs on your computer; neither has a managed environment to control.
Keep the disk under its limit
- Chetty warns you from 80% of the environment's disk limit.
- Past the limit, the environment is stopped automatically.
- A start is refused until you free space or an administrator raises the limit.
- A stopped environment keeps its files, so free space from inside it, from a snapshot you delete, or in the Project.
Tip: Delete snapshots you no longer need in the same Environments tab. Each one holds a full copy of the environment on disk.
Related guides
Read Check a Project's load history to see the disk and CPU figures over time, and Projects overview for the other Project tasks.