Managing Environments

The Environments page in the dashboard gives you full visibility into all your active preview environments.

Environment Status

Each environment goes through several states:

Environment Details

The environments table shows:

• URL — Click to open the preview in a new tab
• Status — Color-coded status indicator
• Region — Deployment region (us, eu, apac, latam)
• Type — Project type (node, python, static, etc.)
• TTL — Time-to-live duration
• Created — When the environment was deployed
• Expires — When it will be automatically destroyed

Usage Tracking

A progress bar at the top shows your current environment usage:

Environments: 3 / 5

This counts against your plan limit plus any add-on environments.

Table & Grid Views

Toggle between table view (compact, sortable columns) and grid view (cards with more detail). Your preference is saved in your browser.

QR Codes

Each running environment shows a QR code for easy mobile sharing. In grid view, a small QR thumbnail appears next to the status badge — click it to open a full-size scannable modal with a copy-to-clipboard button.

In table view, click the QR icon in the Actions column to open the same modal.

CPU & RAM Monitoring

Running environments display real-time CPU and RAM usage bars. Stats are fetched from the Nomad cluster and update with each polling cycle.

One-Click Redeploy

Click the redeploy button (circular arrow icon) to restart an environment with the same Docker image. This is useful when the application has crashed or entered a bad state. The URL stays the same.

For deploying new code to the same URL, use prev create --to from the CLI. See In-Place Updates for details.

Build Logs

For environments built from source code, click the build log button (document icon) to view the Docker build output. This is helpful for debugging failed deployments — you can see exactly which build step failed.

Destroying Environments

Click the destroy button next to any environment to remove it. You'll be asked to confirm before deletion. Destroyed environments are automatically archived to the Deployment History page, where you can redeploy them later.

Extending TTL (Business Plan)

Business plan users can extend the TTL of running environments directly from the dashboard. Quick-extend buttons offer preset durations (default: 15 minutes, 1 hour, 24 hours). These presets can be customized in Dashboard > Settings.

The extended TTL cannot exceed the maximum allowed by your plan (14 days for Business).

Real-Time Updates

The dashboard polls for status updates every 5 seconds while the page is active. Polling pauses when you switch to another browser tab to save resources.