Appaloft Docsv685dc5b2b9b264bb9b5749efdc50a341b407289b
Environments And Configuration

Environment model

Understand how environments isolate configuration and participate in deployment snapshots.

An environment is the user boundary for deploy-time configuration, such as development, staging, or production.

A resource can be deployed in different environments. Each deployment reads the target environment configuration and stores an immutable snapshot.

Environments start as active. Locking an environment keeps the environment, variables, resources, deployments, and history readable, but blocks new environment variable writes, promotion, resource creation, and deployment admission. Unlocking returns it to active.

Renaming an active environment changes only the environment name. It does not change the environment id, variables, resources, deployments, domains, certificates, or runtime state. Locked and archived environments cannot be renamed.

Cloning an active environment creates a new active environment in the same project with a new name and a copy of the source environment variables. It does not copy resources, deployments, domains, certificates, or runtime state.

Archiving an environment keeps the same history readable, but it is a retired state and is not restored by unlock.

Clone, lock, unlock, and archive do not stop runtime, delete resources, clean up domains, or remove certificates. Use the explicit resource, deployment, domain, or certificate commands for those cleanup tasks.