---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "dokploy_environment Resource - dokploy"
subcategory: ""
description: |-
  An environment inside a Dokploy project, such as staging or production. Services belong to an environment rather than directly to a project.
  Dokploy creates a default production environment with every project; reference it via dokploy_project.<name>.default_environment_id instead of declaring it here.
---

# dokploy_environment (Resource)

An environment inside a Dokploy project, such as `staging` or `production`. Services belong to an environment rather than directly to a project.

Dokploy creates a default `production` environment with every project; reference it via `dokploy_project.<name>.default_environment_id` instead of declaring it here.



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `name` (String) Environment name, for example `staging`.
- `project_id` (String) Project this environment belongs to.

### Optional

- `description` (String) Free-form description.
- `env` (String) Environment-wide variables in `KEY=value` format, one per line. These are merged into every service in this environment.

### Read-Only

- `created_at` (String) RFC 3339 timestamp of when the environment was created.
- `id` (String) Unique environment identifier.
- `is_default` (Boolean) Whether this is the project's default environment.