# Portainer Business Edition

> Advanced Docker and Kubernetes management with RBAC and GitOps.

- Category: DevOps & CI/CD
- Difficulty: intermediate
- Components: portainer-be, portainer-agent
- Tags: docker, kubernetes, portainer, container-management, devops
- Source: https://docker.recipes/devops/portainer-business

## Overview

Portainer Business Edition transforms container management with enterprise-grade features for Docker, Kubernetes, and container orchestration platforms. Originally developed as an open-source Docker management tool, Portainer has evolved into a comprehensive container platform that bridges the gap between simple container operations and complex enterprise orchestration needs. The Business Edition adds critical enterprise features like role-based access control (RBAC), GitOps workflows, advanced registry management, and multi-environment governance that make it suitable for production deployments at scale. This stack combines Portainer Business Edition with the Portainer Agent to create a distributed management architecture where the main Portainer instance provides the web interface and management capabilities while agents deployed across multiple Docker hosts enable centralized control of distributed container infrastructure. The agent component allows Portainer to manage remote Docker environments securely, collecting real-time metrics and enabling operations across multiple hosts from a single management interface. Organizations choose this combination when they need enterprise-grade container management that goes beyond basic Docker operations to include team collaboration, compliance controls, and automated deployment workflows. The Business Edition's advanced features like custom templates, edge computing management, and integrated authentication make it particularly valuable for teams that have outgrown simple container management tools but need something more accessible than complex orchestration platforms like OpenShift or Rancher.

## Features

- Enterprise RBAC with team-based access controls and custom role definitions
- GitOps integration for automated stack deployments from Git repositories
- Advanced registry management with vulnerability scanning and image lifecycle policies
- Multi-environment management across Docker, Kubernetes, and Azure Container Instances
- Edge computing support with offline-capable agents for remote deployments
- Custom application templates marketplace with organizational template sharing
- Authentication integration with LDAP, OAuth, and SAML providers
- Audit logging and compliance reporting for container operations

## Use cases

- Enterprise teams managing multi-tenant container infrastructure with strict access controls
- DevOps teams implementing GitOps workflows for automated application deployments
- Organizations running hybrid Docker and Kubernetes environments from single interface
- Remote edge computing deployments requiring centralized management of distributed agents
- Development teams needing self-service container deployment with governance guardrails
- MSPs managing container infrastructure across multiple client environments
- Regulated industries requiring audit trails and compliance controls for container operations

## Prerequisites

- Docker Engine 17.06 or later with API version 1.30+
- Minimum 512MB RAM for Portainer BE (1GB+ recommended for production)
- Available ports 8000, 9001, and 9443 on the host system
- Valid Portainer Business Edition license key for enterprise features
- Network connectivity between Portainer server and agent on port 9001
- Understanding of Docker concepts and basic container orchestration principles

## docker-compose.yml

```yaml
services:
  portainer:
    image: portainer/portainer-ee:latest
    container_name: portainer
    command: -H unix:///var/run/docker.sock
    environment:
      - VIRTUAL_HOST=${PORTAINER_HOST}
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer-data:/data
    ports:
      - "8000:8000"
      - "9443:9443"
    networks:
      - portainer-network
    restart: unless-stopped

  agent:
    image: portainer/agent:latest
    container_name: portainer-agent
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
    ports:
      - "9001:9001"
    networks:
      - portainer-network
    restart: unless-stopped

volumes:
  portainer-data:

networks:
  portainer-network:
    driver: bridge
```

## .env

```bash
# Portainer Business
PORTAINER_HOST=portainer.localhost

# Business Edition requires license
# Get trial at: https://www.portainer.io/
```

## Usage notes

- Web UI at https://localhost:9443
- Set admin password on first visit
- Business edition requires license
- RBAC, GitOps, registries
- Kubernetes support included

## Troubleshooting

- License validation failed: Ensure your Portainer BE license is valid and not expired in the license management section
- Agent connection timeout: Verify port 9001 is accessible and not blocked by firewall between Portainer and agent
- GitOps repository sync failing: Check that the Git repository URL is accessible and authentication credentials are correct
- RBAC permissions not applying: Verify user team assignments and role mappings in the user management interface
- Template deployment failed: Ensure the custom template variables are properly defined and Docker socket permissions allow image pulls
- Edge agent offline status: Check network connectivity and verify the edge key hasn't expired in the edge computing section

