Devpilot
Workspaces

System and Workspace Settings

Manage global cloud provider availability and per-workspace settings in Devpilot.

System and Workspace Settings

Devpilot separates configuration into two layers:

  • System settings are global to the Devpilot instance and govern which cloud providers are available when any workspace provisions infrastructure.
  • Workspace settings are scoped to a single workspace and hold operational preferences for that workspace alone.

This page covers both layers, who can change each one, and how to use them safely.

System Settings: Cloud Provider Availability

System settings control which cloud providers are enabled for server provisioning. This list is shared across every workspace on the instance.

Supported Providers

Devpilot ships with support for the following providers:

Provider keyProvider name
awsAmazon Web Services
azureMicrosoft Azure
gcpGoogle Cloud Platform
digitaloceanDigitalOcean
hetznerHetzner Cloud
vultrVultr

Each provider carries an Active or Inactive status. When a provider is Active, workspaces can use it to provision servers; when Inactive, it is hidden from the provisioning flows and cannot be selected in any workspace.

Viewing Providers

Open System Settings > Cloud Providers to see every provider and its current status. The list is fetched directly from the database, so it always reflects the most recent toggle.

Toggling a Provider

Open Cloud Providers

In System Settings > Cloud Providers, find the provider you want to change.

Flip the Status

Set the provider's status to Active or Inactive. Only these two values are accepted — any other value is rejected with a validation error.

Let the Cache Refresh

Saving the new status clears the provider cache so the change is picked up on the very next provisioning request. No restart or redeploy is required.

Deactivating a provider does not delete or stop the servers that were already provisioned through it. It only prevents new servers from being provisioned on that provider. Existing servers keep running and remain manageable.

Cloud-provider toggles are a system-wide setting. Flipping one affects every workspace on the Devpilot instance, so coordinate with other workspace Owners before turning a provider off in a shared deployment.

When to Deactivate a Provider

  • Decommissioning a cloud — you no longer want new servers to land on that provider.
  • Compliance scoping — a region-specific regulation requires the team to provision only on a whitelist.
  • Cost control — pausing a more expensive provider while the team standardises on a cheaper one.
  • Outage response — a provider is unavailable and you want to stop users from trying to provision there until it recovers.

In every case, deactivating stops new provisioning but leaves existing servers and their billing records intact.

Workspace Settings

Each workspace has its own settings object, editable by workspace Owners and Admins. Workspace settings are stored as a JSON document, giving each workspace a flexible place to hold its own preferences without touching other workspaces.

Who Can View and Change Workspace Settings

ActionRequired workspace role
View the current workspace settingsOwner, Admin
Update the workspace settingsOwner, Admin

Members do not see the Settings page.

Viewing Workspace Settings

Open the Workspace

Navigate to the workspace you want to configure.

Go to Settings

Choose Settings from the workspace sidebar. You will see the current JSON-backed settings object. An empty object is returned when no settings have been saved yet.

Updating Workspace Settings

Edit the Settings Object

Update the fields exposed by the Settings UI. Each workspace may expose a different set of keys depending on the features it has enabled.

Save

The update requires a non-empty settings object. The submitted object replaces the existing settings, and the new values take effect immediately on subsequent actions. The response returns the stored settings so you can verify the save.

Workspace settings are a generic container. Security-sensitive features — access tokens, API keys, quota alert thresholds, invitations, integrations — expose their own dedicated settings pages that are documented on their respective topic pages.

What Belongs in Workspace Settings

Use workspace settings for preferences that affect how the whole workspace behaves and that should survive across user sessions. Typical examples include:

  • Default preferences that the workspace wants pre-filled when a Member creates a new resource.
  • Feature-flag-style toggles shared by the workspace.
  • Operational preferences that are not big enough to warrant their own full feature page.

For anything with stricter security or auditing requirements, use the dedicated pages:

Tips for Safe Edits

  • Review the current object before you save. The update replaces the existing settings object in one shot, so anything you omit is lost.
  • Coordinate with other admins. Because workspace settings are shared, another Owner or Admin may be relying on the value you are about to change.
  • Keep secrets out of workspace settings. Store API keys and tokens in their dedicated features, which encrypt and scope them correctly.

Who Can Change What — Summary

AreaViewChange
Cloud provider availability (System Settings)Instance operators with system-level accessInstance operators with system-level access
Workspace settingsOwner, AdminOwner, Admin

Members cannot view or change system-level cloud provider toggles, and they cannot view or change workspace settings.

  • Access-related changes a workspace admin makes (role grants, role changes, approvals) are captured in the access audit trail, not here.
  • Activity volume that flows through a workspace (deployments, edits, and so on) is summarised on the team analytics page.

Changes to system-level provider availability and workspace settings themselves are applied immediately and reflected in the workspace's own configuration on the very next page load.

Next steps