Skip to content

Image Configuration

1. Image Overview

Docker images define the container templates used for creating subscription instances. Each image specifies the Odoo version, configuration paths, and environment assignment strategy.

Fields

  1. Name - Image name (required, tracked)
  2. Odoo Version - Version string displayed to clients (required, tracked)
  3. Config File - Configuration file directory path (required, tracked)
  4. Image Tags - Docker image tags (required, Many2many)
  5. Environment - Default Portainer environment
  6. Select Environment By - Assignment strategy (default: sequence):
    • sequence - Pick environment by priority order
    • used - Pick environment with lowest usage (most available capacity)
  7. Active - Archive toggle (default: True)

Image-Environment Mapping

An image can be available in multiple environments. The mapping table tracks which environments can run each image.

  1. Sequence - Priority order for environment selection
  2. Image - Docker image reference (required)
  3. Environment - Portainer environment reference
  4. Environment State - Capacity status (related from environment)
  5. Max Running Containers - Environment capacity (related)
  6. Available Capacity - Remaining slots (related)
  7. Running Containers - Current load (related)
  8. Root Server - Server hosting this environment (related)

Environment Selection

When a new subscription is created, get_best_environment() returns the optimal environment based on the image's selection strategy - either the highest-priority environment (by sequence) or the least-loaded one (by available capacity).

2. Image Tags

Simple labels for organizing and identifying Docker image versions.

Fields

  1. Name - Tag name (required, tracked)