Skip to main content
Early AccessPrebuilds are currently in early access. If you’re interested in trying this feature, please contact us.

​
Viewing Prebuilds

Navigate to your project settings and click the Prebuilds tab to view all prebuilds. All project members can view prebuilds and their logs. Each prebuild shows its status (pending, running, completed, failed, cancelled), environment class, trigger source, and timing information.

​
Viewing Logs

Click on a prebuild and select View Logs to see execution details including Dev Container lifecycle command output, build progress, and error messages. Note: Automation task logs in prebuilds are coming soon. When troubleshooting failures, check logs for error messages, verify required secrets are configured, and ensure commands don’t require user interaction

​
Triggering Prebuilds Manually

Click the Prebuild button in the top right of your project settings to trigger prebuilds for all selected environment classes. For specific environment classes, use the CLI: 
gitpod prebuild trigger <project-id> --environment-class-id <class-id>

​
Cancelling Prebuilds

Cancel a running prebuild from the Prebuilds tab or via CLI: 
gitpod prebuild cancel <prebuild-id>
Cancelled prebuilds consume resources until cleanup completes.

​
CLI Commands

# List prebuilds
gitpod prebuild list --project-id <project-id>

# Get prebuild details
gitpod prebuild get <prebuild-id>

# Delete a prebuild
gitpod prebuild delete <prebuild-id>
See the CLI documentation for configuration commands.

​
Troubleshooting

Prebuild fails: Check logs for errors, verify secrets are configured at organization or project level, and ensure commands don’t require user interaction. Environment doesn’t use prebuild: Verify a successful prebuild exists for the environment class and is less than 7 days old. Prebuild stuck: Review logs for hanging commands, check timeout settings, or cancel and retry.