Managing Preview Environments ScaleEnterpriseSelf-Hosted
The Previews section of the Admin Dashboard provides administrators with a centralized view to manage all Preview Environments in your Okteto instance.
Preview Scope
Preview Environments can have one of two scopes:
- Global Scope (default): The Preview Environment is accessible to all members of your organization. These previews are visible to the entire team and can be managed by users with appropriate permissions.
- Personal Scope: The Preview Environment is only accessible to the owner and anyone they explicitly share it with. These previews are indicated with a user icon next to the preview name in the preview list.
Preview Environments use global scope by default. The scope determines who can view and interact with the Preview Environment within your organization. For more details on user permissions and what actions each role can perform, see Preview Environment Permissions.
Filtering and Searching Previews
The Preview Environments list provides several filtering options to help you find specific previews:
- Search - Search for previews by name using the search box
- Repository - Filter by one or more repositories (searchable dropdown)
- Status - Filter by preview status such as active, sleeping, or error states
- Owner - Filter by the user who created the preview (searchable dropdown)
- Updated - Filter by when the preview was last updated:
- Last hour
- Last 24 hours
- Last 7 days
- Last 30 days
- Last 90 days
You can combine multiple filters to narrow down your search results.
Preview Table Columns
The Preview Environments table displays the following information for each preview:
- Name - The Preview Environment name with a user icon indicator for personal scope previews. Click the name to view details.
- Repository - The repository hosting the code, with a link to view it in your source control provider
- PR - A link to the associated pull request
- Owner - The user who created the Preview Environment
- Status - The current status of the preview (e.g., active, sleeping, deploying)
- Last Updated - When the preview was last modified
- Actions - Available actions for managing the preview
Managing Preview Environments
Each preview has an actions menu with the following options:
- Delete - Remove the Preview Environment. This option is only available if you have the necessary permissions.
- Wake Preview - Wake up a sleeping Preview Environment to make it active again
- Sleep Preview - Put an active Preview Environment to sleep to save resources. This option is disabled for previews marked as "Keep Awake"
- Keep Awake - Toggle to mark a Preview Environment as persistent, preventing it from automatically sleeping due to inactivity. Because the preview remains active, it also prevents automatic deletion by the garbage collector.
Marking a Preview Environment as persistent with "Keep Awake" prevents automatic sleeping and deletion. The preview will remain available at all times until manually deleted. This is useful for long-running demos or environments that need to be always accessible.