---
icon: material/docker
hide:
  - tags
tags:
  - portainer
saltbox_automation:
  app_links:
    - name: Manual
      url: https://docs.portainer.io
      type: documentation
    - name: Releases
      url: https://hub.docker.com/r/portainer/portainer-ce/tags
      type: docker
    - name: Community
      url: https://portainer.io/slack
      type: community
  project_description:
    name: Portainer
    summary: |-
      a lightweight, open-source management UI that provides a graphical interface for managing containerized applications across various environments, including Docker, Kubernetes, Docker Swarm, and Podman.
    link: https://portainer.io
---

<!-- BEGIN SALTBOX MANAGED OVERVIEW SECTION -->
<!-- This section is managed by sb-docs - DO NOT EDIT MANUALLY -->
# Portainer

## Overview

[Portainer](https://portainer.io) is a lightweight, open-source management UI that provides a graphical interface for managing containerized applications across various environments, including Docker, Kubernetes, Docker Swarm, and Podman.

<div class="grid grid--buttons" markdown data-search-exclude>

[:fontawesome-solid-book-open:**Manual**](https://docs.portainer.io){ .md-button .md-button--stretch }

[:fontawesome-brands-docker:**Releases**](https://hub.docker.com/r/portainer/portainer-ce/tags){ .md-button .md-button--stretch }

[:fontawesome-solid-comments:**Community**](https://portainer.io/slack){ .md-button .md-button--stretch }

</div>

---
<!-- END SALTBOX MANAGED OVERVIEW SECTION -->

## Deployment

```shell
sb install portainer
```

## Usage

Visit  <https://portainer.iYOUR_DOMAIN_NAMEi>.

## Next

<div class="sb-cta" markdown>

Are you setting Saltbox up for the first time?

<div markdown>

[**Continue to Organizr**:material-forward:](organizr.md){ .md-button }

</div>

</div>

<!-- BEGIN SALTBOX MANAGED VARIABLES SECTION -->
<!-- This section is managed by sb-docs - DO NOT EDIT MANUALLY -->
## Role Defaults

Variables can be customized using the [Inventory](/saltbox/inventory/index.md#overriding-variables){ data-preview }. <span title="View override specifics for this role" markdown>(1)</span>
{ .annotate .sb-annotated }

1.  !!! example "Example override"

        ```yaml
        portainer_name: "custom_value"
        ```

    !!! warning "Avoid overriding variables ending in `_default`"

        When overriding variables that end in `_default` (like `portainer_docker_envs_default`), you replace the entire default configuration. Future updates that add new default values will not be applied to your setup, potentially breaking functionality.

        Instead, use the corresponding `_custom` variable (like `portainer_docker_envs_custom`) to add your changes. Custom values are merged with defaults, ensuring you receive updates.

=== "Basics"

    ??? variable string "`portainer_name`"

        ```yaml
        # Type: string
        portainer_name: portainer
        ```

=== "Settings"

    ??? variable bool "`portainer_role_business_edition`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_business_edition: false
        ```

=== "Web"

    ??? variable string "`portainer_role_web_subdomain`"

        ```yaml
        # Type: string
        portainer_role_web_subdomain: "{{ portainer_name }}"
        ```

    ??? variable string "`portainer_role_web_domain`"

        ```yaml
        # Type: string
        portainer_role_web_domain: "{{ user.domain }}"
        ```

    ??? variable string "`portainer_role_web_port`"

        ```yaml
        # Type: string
        portainer_role_web_port: "9000"
        ```

    ??? variable string "`portainer_role_web_url`"

        ```yaml
        # Type: string
        portainer_role_web_url: "{{ 'https://' + (lookup('role_var', '_web_subdomain', role='portainer') + '.' + lookup('role_var', '_web_domain', role='portainer')
                                 if (lookup('role_var', '_web_subdomain', role='portainer') | length > 0)
                                 else lookup('role_var', '_web_domain', role='portainer')) }}"
        ```

=== "DNS"

    ??? variable string "`portainer_role_dns_record`"

        ```yaml
        # Type: string
        portainer_role_dns_record: "{{ lookup('role_var', '_web_subdomain', role='portainer') }}"
        ```

    ??? variable string "`portainer_role_dns_zone`"

        ```yaml
        # Type: string
        portainer_role_dns_zone: "{{ lookup('role_var', '_web_domain', role='portainer') }}"
        ```

    ??? variable bool "`portainer_role_dns_proxy`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_dns_proxy: "{{ dns_proxied }}"
        ```

=== "Traefik"

    ??? variable string "`portainer_role_traefik_sso_middleware`"

        ```yaml
        # Type: string
        portainer_role_traefik_sso_middleware: "{{ traefik_default_sso_middleware }}"
        ```

    ??? variable string "`portainer_role_traefik_middleware_default`"

        ```yaml
        # Type: string
        portainer_role_traefik_middleware_default: "{{ traefik_default_middleware
                                                       + (',themepark-' + portainer_name
                                                         if (lookup('role_var', '_themepark_enabled', role='portainer') and global_themepark_plugin_enabled)
                                                         else '') }}"
        ```

    ??? variable string "`portainer_role_traefik_middleware_custom`"

        ```yaml
        # Type: string
        portainer_role_traefik_middleware_custom: ""
        ```

    ??? variable string "`portainer_role_traefik_certresolver`"

        ```yaml
        # Type: string
        portainer_role_traefik_certresolver: "{{ traefik_default_certresolver }}"
        ```

    ??? variable bool "`portainer_role_traefik_enabled`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_traefik_enabled: true
        ```

    ??? variable bool "`portainer_role_traefik_api_enabled`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_traefik_api_enabled: true
        ```

    ??? variable string "`portainer_role_traefik_api_endpoint`"

        ```yaml
        # Type: string
        portainer_role_traefik_api_endpoint: "PathPrefix(`/api`)"
        ```

=== "Theme"

    ??? variable bool "`portainer_role_themepark_enabled`"

        ```yaml
        # Options can be found at https://github.com/themepark-dev/theme.park
        # Type: bool (true/false)
        portainer_role_themepark_enabled: false
        ```

    ??? variable string "`portainer_role_themepark_theme`"

        ```yaml
        # Type: string
        portainer_role_themepark_theme: "{{ global_themepark_theme }}"
        ```

=== "Docker"

    <h5>Container</h5>

    ??? variable string "`portainer_role_docker_container`"

        ```yaml
        # Type: string
        portainer_role_docker_container: "{{ portainer_name }}"
        ```

    <h5>Image</h5>

    ??? variable bool "`portainer_role_docker_image_pull`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_image_pull: true
        ```

    ??? variable string "`portainer_role_docker_image_tag`"

        ```yaml
        # Type: string
        portainer_role_docker_image_tag: "alpine"
        ```

    ??? variable string "`portainer_role_docker_image_repo`"

        ```yaml
        # Type: string
        portainer_role_docker_image_repo: "{{ 'portainer/portainer-ee'
                                           if lookup('role_var', '_business_edition', role='portainer')
                                           else 'portainer/portainer-ce' }}"
        ```

    ??? variable string "`portainer_role_docker_image`"

        ```yaml
        # Type: string
        portainer_role_docker_image: "{{ lookup('role_var', '_docker_image_repo', role='portainer') }}:{{ lookup('role_var', '_docker_image_tag', role='portainer') }}"
        ```

    <h5>Envs</h5>

    ??? variable dict "`portainer_role_docker_envs_default`"

        ```yaml
        # Type: dict
        portainer_role_docker_envs_default:
          TZ: "{{ tz }}"
        ```

    ??? variable dict "`portainer_role_docker_envs_custom`"

        ```yaml
        # Type: dict
        portainer_role_docker_envs_custom: {}
        ```

    <h5>Volumes</h5>

    ??? variable list "`portainer_role_docker_volumes_default`"

        ```yaml
        # Type: list
        portainer_role_docker_volumes_default:
          - "{{ portainer_role_paths_location }}:/data"
          - "/var/run/docker.sock:/var/run/docker.sock"
        ```

    ??? variable list "`portainer_role_docker_volumes_custom`"

        ```yaml
        # Type: list
        portainer_role_docker_volumes_custom: []
        ```

    <h5>Labels</h5>

    ??? variable dict "`portainer_role_docker_labels_custom`"

        ```yaml
        # Type: dict
        portainer_role_docker_labels_custom: {}
        ```

    <h5>Hostname</h5>

    ??? variable string "`portainer_role_docker_hostname`"

        ```yaml
        # Type: string
        portainer_role_docker_hostname: "{{ portainer_name }}"
        ```

    <h5>Networks</h5>

    ??? variable string "`portainer_role_docker_networks_alias`"

        ```yaml
        # Type: string
        portainer_role_docker_networks_alias: "{{ portainer_name }}"
        ```

    ??? variable list "`portainer_role_docker_networks_default`"

        ```yaml
        # Type: list
        portainer_role_docker_networks_default: []
        ```

    ??? variable list "`portainer_role_docker_networks_custom`"

        ```yaml
        # Type: list
        portainer_role_docker_networks_custom: []
        ```

    <h5>Restart Policy</h5>

    ??? variable string "`portainer_role_docker_restart_policy`"

        ```yaml
        # Type: string
        portainer_role_docker_restart_policy: unless-stopped
        ```

    <h5>State</h5>

    ??? variable string "`portainer_role_docker_state`"

        ```yaml
        # Type: string
        portainer_role_docker_state: started
        ```

=== "Docker+"

    The following advanced options are available via create_docker_container but are not defined in the role. See: [docker_container module](https://docs.ansible.com/ansible/latest/collections/community/docker/docker_container_module.html)

    <h5>Resource Limits</h5>

    ??? variable int "`portainer_role_docker_blkio_weight`"

        ```yaml
        # Type: int
        portainer_role_docker_blkio_weight:
        ```

    ??? variable int "`portainer_role_docker_cpu_period`"

        ```yaml
        # Type: int
        portainer_role_docker_cpu_period:
        ```

    ??? variable int "`portainer_role_docker_cpu_quota`"

        ```yaml
        # Type: int
        portainer_role_docker_cpu_quota:
        ```

    ??? variable int "`portainer_role_docker_cpu_shares`"

        ```yaml
        # Type: int
        portainer_role_docker_cpu_shares:
        ```

    ??? variable string "`portainer_role_docker_cpus`"

        ```yaml
        # Type: string
        portainer_role_docker_cpus:
        ```

    ??? variable string "`portainer_role_docker_cpuset_cpus`"

        ```yaml
        # Type: string
        portainer_role_docker_cpuset_cpus:
        ```

    ??? variable string "`portainer_role_docker_cpuset_mems`"

        ```yaml
        # Type: string
        portainer_role_docker_cpuset_mems:
        ```

    ??? variable string "`portainer_role_docker_kernel_memory`"

        ```yaml
        # Type: string
        portainer_role_docker_kernel_memory:
        ```

    ??? variable string "`portainer_role_docker_memory`"

        ```yaml
        # Type: string
        portainer_role_docker_memory:
        ```

    ??? variable string "`portainer_role_docker_memory_reservation`"

        ```yaml
        # Type: string
        portainer_role_docker_memory_reservation:
        ```

    ??? variable string "`portainer_role_docker_memory_swap`"

        ```yaml
        # Type: string
        portainer_role_docker_memory_swap:
        ```

    ??? variable int "`portainer_role_docker_memory_swappiness`"

        ```yaml
        # Type: int
        portainer_role_docker_memory_swappiness:
        ```

    ??? variable string "`portainer_role_docker_shm_size`"

        ```yaml
        # Type: string
        portainer_role_docker_shm_size:
        ```

    <h5>Security & Devices</h5>

    ??? variable list "`portainer_role_docker_cap_drop`"

        ```yaml
        # Type: list
        portainer_role_docker_cap_drop:
        ```

    ??? variable string "`portainer_role_docker_cgroupns_mode`"

        ```yaml
        # Type: string
        portainer_role_docker_cgroupns_mode:
        ```

    ??? variable list "`portainer_role_docker_device_cgroup_rules`"

        ```yaml
        # Type: list
        portainer_role_docker_device_cgroup_rules:
        ```

    ??? variable list "`portainer_role_docker_device_read_bps`"

        ```yaml
        # Type: list
        portainer_role_docker_device_read_bps:
        ```

    ??? variable list "`portainer_role_docker_device_read_iops`"

        ```yaml
        # Type: list
        portainer_role_docker_device_read_iops:
        ```

    ??? variable list "`portainer_role_docker_device_requests`"

        ```yaml
        # Type: list
        portainer_role_docker_device_requests:
        ```

    ??? variable list "`portainer_role_docker_device_write_bps`"

        ```yaml
        # Type: list
        portainer_role_docker_device_write_bps:
        ```

    ??? variable list "`portainer_role_docker_device_write_iops`"

        ```yaml
        # Type: list
        portainer_role_docker_device_write_iops:
        ```

    ??? variable list "`portainer_role_docker_devices`"

        ```yaml
        # Type: list
        portainer_role_docker_devices:
        ```

    ??? variable list "`portainer_role_docker_groups`"

        ```yaml
        # Type: list
        portainer_role_docker_groups:
        ```

    ??? variable bool "`portainer_role_docker_privileged`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_privileged:
        ```

    ??? variable list "`portainer_role_docker_security_opts`"

        ```yaml
        # Type: list
        portainer_role_docker_security_opts:
        ```

    ??? variable string "`portainer_role_docker_user`"

        ```yaml
        # Type: string
        portainer_role_docker_user:
        ```

    ??? variable string "`portainer_role_docker_userns_mode`"

        ```yaml
        # Type: string
        portainer_role_docker_userns_mode:
        ```

    <h5>Networking</h5>

    ??? variable list "`portainer_role_docker_dns_opts`"

        ```yaml
        # Type: list
        portainer_role_docker_dns_opts:
        ```

    ??? variable list "`portainer_role_docker_dns_search_domains`"

        ```yaml
        # Type: list
        portainer_role_docker_dns_search_domains:
        ```

    ??? variable list "`portainer_role_docker_dns_servers`"

        ```yaml
        # Type: list
        portainer_role_docker_dns_servers:
        ```

    ??? variable string "`portainer_role_docker_domainname`"

        ```yaml
        # Type: string
        portainer_role_docker_domainname:
        ```

    ??? variable list "`portainer_role_docker_exposed_ports`"

        ```yaml
        # Type: list
        portainer_role_docker_exposed_ports:
        ```

    ??? variable dict "`portainer_role_docker_hosts`"

        ```yaml
        # Type: dict
        portainer_role_docker_hosts:
        ```

    ??? variable bool "`portainer_role_docker_hosts_use_common`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_hosts_use_common:
        ```

    ??? variable string "`portainer_role_docker_ipc_mode`"

        ```yaml
        # Type: string
        portainer_role_docker_ipc_mode:
        ```

    ??? variable list "`portainer_role_docker_links`"

        ```yaml
        # Type: list
        portainer_role_docker_links:
        ```

    ??? variable string "`portainer_role_docker_network_mode`"

        ```yaml
        # Type: string
        portainer_role_docker_network_mode:
        ```

    ??? variable string "`portainer_role_docker_pid_mode`"

        ```yaml
        # Type: string
        portainer_role_docker_pid_mode:
        ```

    ??? variable list "`portainer_role_docker_ports`"

        ```yaml
        # Type: list
        portainer_role_docker_ports:
        ```

    ??? variable string "`portainer_role_docker_uts`"

        ```yaml
        # Type: string
        portainer_role_docker_uts:
        ```

    <h5>Storage</h5>

    ??? variable bool "`portainer_role_docker_keep_volumes`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_keep_volumes:
        ```

    ??? variable list "`portainer_role_docker_mounts`"

        ```yaml
        # Type: list
        portainer_role_docker_mounts:
        ```

    ??? variable dict "`portainer_role_docker_storage_opts`"

        ```yaml
        # Type: dict
        portainer_role_docker_storage_opts:
        ```

    ??? variable list "`portainer_role_docker_tmpfs`"

        ```yaml
        # Type: list
        portainer_role_docker_tmpfs:
        ```

    ??? variable string "`portainer_role_docker_volume_driver`"

        ```yaml
        # Type: string
        portainer_role_docker_volume_driver:
        ```

    ??? variable list "`portainer_role_docker_volumes_from`"

        ```yaml
        # Type: list
        portainer_role_docker_volumes_from:
        ```

    ??? variable bool "`portainer_role_docker_volumes_global`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_volumes_global:
        ```

    ??? variable string "`portainer_role_docker_working_dir`"

        ```yaml
        # Type: string
        portainer_role_docker_working_dir:
        ```

    <h5>Monitoring & Lifecycle</h5>

    ??? variable bool "`portainer_role_docker_auto_remove`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_auto_remove:
        ```

    ??? variable bool "`portainer_role_docker_cleanup`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_cleanup:
        ```

    ??? variable string "`portainer_role_docker_force_kill`"

        ```yaml
        # Type: string
        portainer_role_docker_force_kill:
        ```

    ??? variable dict "`portainer_role_docker_healthcheck`"

        ```yaml
        # Type: dict
        portainer_role_docker_healthcheck:
        ```

    ??? variable int "`portainer_role_docker_healthy_wait_timeout`"

        ```yaml
        # Type: int
        portainer_role_docker_healthy_wait_timeout:
        ```

    ??? variable bool "`portainer_role_docker_init`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_init:
        ```

    ??? variable string "`portainer_role_docker_kill_signal`"

        ```yaml
        # Type: string
        portainer_role_docker_kill_signal:
        ```

    ??? variable string "`portainer_role_docker_log_driver`"

        ```yaml
        # Type: string
        portainer_role_docker_log_driver:
        ```

    ??? variable dict "`portainer_role_docker_log_options`"

        ```yaml
        # Type: dict
        portainer_role_docker_log_options:
        ```

    ??? variable bool "`portainer_role_docker_oom_killer`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_oom_killer:
        ```

    ??? variable int "`portainer_role_docker_oom_score_adj`"

        ```yaml
        # Type: int
        portainer_role_docker_oom_score_adj:
        ```

    ??? variable bool "`portainer_role_docker_output_logs`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_output_logs:
        ```

    ??? variable bool "`portainer_role_docker_paused`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_paused:
        ```

    ??? variable bool "`portainer_role_docker_recreate`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_recreate:
        ```

    ??? variable int "`portainer_role_docker_restart_retries`"

        ```yaml
        # Type: int
        portainer_role_docker_restart_retries:
        ```

    ??? variable string "`portainer_role_docker_stop_signal`"

        ```yaml
        # Type: string
        portainer_role_docker_stop_signal:
        ```

    ??? variable int "`portainer_role_docker_stop_timeout`"

        ```yaml
        # Type: int
        portainer_role_docker_stop_timeout:
        ```

    <h5>Other Options</h5>

    ??? variable list "`portainer_role_docker_capabilities`"

        ```yaml
        # Type: list
        portainer_role_docker_capabilities:
        ```

    ??? variable string "`portainer_role_docker_cgroup_parent`"

        ```yaml
        # Type: string
        portainer_role_docker_cgroup_parent:
        ```

    ??? variable list "`portainer_role_docker_commands`"

        ```yaml
        # Type: list
        portainer_role_docker_commands:
        ```

    ??? variable int "`portainer_role_docker_create_timeout`"

        ```yaml
        # Type: int
        portainer_role_docker_create_timeout:
        ```

    ??? variable string "`portainer_role_docker_entrypoint`"

        ```yaml
        # Type: string
        portainer_role_docker_entrypoint:
        ```

    ??? variable string "`portainer_role_docker_env_file`"

        ```yaml
        # Type: string
        portainer_role_docker_env_file:
        ```

    ??? variable bool "`portainer_role_docker_labels_use_common`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_labels_use_common:
        ```

    ??? variable bool "`portainer_role_docker_read_only`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_read_only:
        ```

    ??? variable string "`portainer_role_docker_runtime`"

        ```yaml
        # Type: string
        portainer_role_docker_runtime:
        ```

    ??? variable list "`portainer_role_docker_sysctls`"

        ```yaml
        # Type: list
        portainer_role_docker_sysctls:
        ```

    ??? variable list "`portainer_role_docker_ulimits`"

        ```yaml
        # Type: list
        portainer_role_docker_ulimits:
        ```

=== "Global Override Options"

    ??? variable bool "`portainer_role_autoheal_enabled`"

        ```yaml
        # Enable or disable Autoheal monitoring for the container created when deploying
        # Type: bool (true/false)
        portainer_role_autoheal_enabled: true
        ```

    ??? variable string "`portainer_role_depends_on`"

        ```yaml
        # List of container dependencies that must be running before the container start
        # Type: string
        portainer_role_depends_on: ""
        ```

    ??? variable string "`portainer_role_depends_on_delay`"

        ```yaml
        # Delay in seconds before starting the container after dependencies are ready
        # Type: string (quoted number)
        portainer_role_depends_on_delay: "0"
        ```

    ??? variable string "`portainer_role_depends_on_healthchecks`"

        ```yaml
        # Enable healthcheck waiting for container dependencies
        # Type: string ("true"/"false")
        portainer_role_depends_on_healthchecks:
        ```

    ??? variable bool "`portainer_role_diun_enabled`"

        ```yaml
        # Enable or disable Diun update notifications for the container created when deploying
        # Type: bool (true/false)
        portainer_role_diun_enabled: true
        ```

    ??? variable bool "`portainer_role_dns_enabled`"

        ```yaml
        # Enable or disable automatic DNS record creation for the container
        # Type: bool (true/false)
        portainer_role_dns_enabled: true
        ```

    ??? variable bool "`portainer_role_docker_controller`"

        ```yaml
        # Enable or disable Saltbox Docker Controller management for the container
        # Type: bool (true/false)
        portainer_role_docker_controller: true
        ```

    ??? variable list "`portainer_role_docker_networks_alias_custom`"

        ```yaml
        # Type: list
        portainer_role_docker_networks_alias_custom:
        ```

    ??? variable bool "`portainer_role_docker_volumes_download`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_docker_volumes_download:
        ```

    ??? variable string "`portainer_role_themepark_addons`"

        ```yaml
        # Type: string
        portainer_role_themepark_addons:
        ```

    ??? variable string "`portainer_role_themepark_app`"

        ```yaml
        # Type: string
        portainer_role_themepark_app:
        ```

    ??? variable string "`portainer_role_traefik_api_middleware`"

        ```yaml
        # Type: string
        portainer_role_traefik_api_middleware:
        ```

    ??? variable string "`portainer_role_traefik_api_middleware_http`"

        ```yaml
        # Type: string
        portainer_role_traefik_api_middleware_http:
        ```

    ??? variable bool "`portainer_role_traefik_autodetect_enabled`"

        ```yaml
        # Enable Traefik autodetect middleware for the container
        # Type: bool (true/false)
        portainer_role_traefik_autodetect_enabled: false
        ```

    ??? variable bool "`portainer_role_traefik_crowdsec_enabled`"

        ```yaml
        # Enable CrowdSec middleware for the container
        # Type: bool (true/false)
        portainer_role_traefik_crowdsec_enabled: false
        ```

    ??? variable bool "`portainer_role_traefik_error_pages_enabled`"

        ```yaml
        # Enable custom error pages middleware for the container
        # Type: bool (true/false)
        portainer_role_traefik_error_pages_enabled: false
        ```

    ??? variable bool "`portainer_role_traefik_gzip_enabled`"

        ```yaml
        # Enable gzip compression middleware for the container
        # Type: bool (true/false)
        portainer_role_traefik_gzip_enabled: false
        ```

    ??? variable string "`portainer_role_traefik_middleware_http`"

        ```yaml
        # Type: string
        portainer_role_traefik_middleware_http:
        ```

    ??? variable bool "`portainer_role_traefik_middleware_http_api_insecure`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_traefik_middleware_http_api_insecure:
        ```

    ??? variable bool "`portainer_role_traefik_middleware_http_insecure`"

        ```yaml
        # Type: bool (true/false)
        portainer_role_traefik_middleware_http_insecure:
        ```

    ??? variable string "`portainer_role_traefik_priority`"

        ```yaml
        # Type: string
        portainer_role_traefik_priority:
        ```

    ??? variable bool "`portainer_role_traefik_robot_enabled`"

        ```yaml
        # Enable robots.txt middleware for the container
        # Type: bool (true/false)
        portainer_role_traefik_robot_enabled: true
        ```

    ??? variable bool "`portainer_role_traefik_tailscale_enabled`"

        ```yaml
        # Enable Tailscale-specific Traefik configuration for the container
        # Type: bool (true/false)
        portainer_role_traefik_tailscale_enabled: false
        ```

    ??? variable bool "`portainer_role_traefik_wildcard_enabled`"

        ```yaml
        # Enable wildcard certificate for the container
        # Type: bool (true/false)
        portainer_role_traefik_wildcard_enabled: true
        ```

    ??? variable string "`portainer_role_web_api_http_port`"

        ```yaml
        # Type: string (quoted number)
        portainer_role_web_api_http_port:
        ```

    ??? variable string "`portainer_role_web_api_http_scheme`"

        ```yaml
        # Type: string ("http"/"https")
        portainer_role_web_api_http_scheme:
        ```

    ??? variable dict "`portainer_role_web_api_http_serverstransport`"

        ```yaml
        # Type: dict/omit
        portainer_role_web_api_http_serverstransport:
        ```

    ??? variable string "`portainer_role_web_api_port`"

        ```yaml
        # Type: string (quoted number)
        portainer_role_web_api_port:
        ```

    ??? variable string "`portainer_role_web_api_scheme`"

        ```yaml
        # Type: string ("http"/"https")
        portainer_role_web_api_scheme:
        ```

    ??? variable dict "`portainer_role_web_api_serverstransport`"

        ```yaml
        # Type: dict/omit
        portainer_role_web_api_serverstransport:
        ```

    ??? variable list "`portainer_role_web_fqdn_override`"

        ```yaml
        # Override the Traefik fully qualified domain name (FQDN) for the container
        # Type: list
        portainer_role_web_fqdn_override:
        ```

        !!! example "Example Override"

            ```yaml
            portainer_role_web_fqdn_override:
              - "{{ traefik_host }}"
              - "portainer2.{{ user.domain }}"
              - "portainer.otherdomain.tld"
            ```

            Note: Include `{{ traefik_host }}` to preserve the default FQDN alongside your custom entries


    ??? variable string "`portainer_role_web_host_override`"

        ```yaml
        # Override the Traefik web host configuration for the container
        # Type: string
        portainer_role_web_host_override:
        ```

        !!! example "Example Override"

            ```yaml
            portainer_role_web_host_override: "Host(`{{ traefik_host }}`) || Host(`{{ 'portainer2.' + user.domain }}`)"
            ```

            Note: Use `{{ traefik_host }}` to include the default host configuration in your custom rule


    ??? variable string "`portainer_role_web_http_port`"

        ```yaml
        # Type: string (quoted number)
        portainer_role_web_http_port:
        ```

    ??? variable string "`portainer_role_web_http_scheme`"

        ```yaml
        # Type: string ("http"/"https")
        portainer_role_web_http_scheme:
        ```

    ??? variable dict "`portainer_role_web_http_serverstransport`"

        ```yaml
        # Type: dict/omit
        portainer_role_web_http_serverstransport:
        ```

    ??? variable string "`portainer_role_web_scheme`"

        ```yaml
        # URL scheme to use for web access to the container
        # Type: string ("http"/"https")
        portainer_role_web_scheme:
        ```

    ??? variable dict "`portainer_role_web_serverstransport`"

        ```yaml
        # Type: dict/omit
        portainer_role_web_serverstransport:
        ```
<!-- END SALTBOX MANAGED VARIABLES SECTION -->