Skip to content

Environments

1. Environment Overview

Portainer environments represent Docker hosts (standalone Docker instances) managed through a Portainer server. Each environment tracks container capacity, resource usage, and infrastructure configuration.

Fields

  1. Name - Environment display name (required, tracked)
  2. IP - Environment IP address (required, tracked)
  3. Portainer - Associated Portainer server (required)
  4. Portainer Environment ID - ID on the Portainer server (required)
  5. Root Server - Associated root server
  6. Environment Type - Docker type (default: standalone)
  7. Next Port - Last used port for allocating new services (default: 10000, tracked)
  8. Active - Archive toggle (default: True)
  9. Country - Location country
  10. State - Location state/province

Capacity Tracking

  1. Max Running Container Count - Docker capacity limit
  2. Container Run - Currently running containers
  3. Container Stop - Stopped containers
  4. Container Pause - Paused containers
  5. Container Total - Total container count
  6. Available Container Capacity - Computed: max - running
  7. State - Capacity status: Normal or Over Capacity (computed)

Resources

  1. CPU Cores - Number of CPU cores
  2. Total RAM - Total memory in MB

Infrastructure Configuration

  1. Nginx Proxy Server - Default Nginx connector for subscriptions (required, tracked)
  2. Nginx Default Cert ID - Default SSL certificate ID (tracked)
  3. Domain for New Subscriptions - Base domain for auto-generated subdomains (tracked)
  4. Subdomain Start - Prefix for auto-created subscription subdomains (tracked)
  5. Cloudflare DNS - Enable Cloudflare DNS management (tracked)
  6. Cloudflare Account - Cloudflare connector (tracked)
  7. Cloudflare Domain Zone ID - Zone ID for DNS operations (tracked)
  8. Cloudflare Create Record - Auto-create DNS records (tracked)
  9. Cloudflare Proxied Record - Proxy DNS records through Cloudflare (tracked)
  10. External PostgreSQL - Use external PostgreSQL server (default: False, tracked)
  11. PostgreSQL Server - External database server reference

2. Actions

Action Description
Get Environment Info Refreshes container counts and resource data from Portainer API

Capacity State

The environment state is automatically computed. When Available Container Capacity drops to 0 or below, the state changes to Over Capacity, indicating the environment cannot accept new subscriptions.