SUMMARY.md

Table of contents

• Welcome
• What's new in version 2.17
• Release Notes

Getting Started

• Introduction
• Portainer architecture
• Requirements and prerequisites
• Install Portainer BE
  • Set up a new Portainer BE Server installation
    • Docker Standalone
      • Install Portainer BE with Docker on Linux
      • Install Portainer BE with Docker on WSL / Docker Desktop
      • Install Portainer BE with Docker on Windows Container Service
    • Docker Swarm
      • Install Portainer BE with Docker Swarm on Linux
      • Install Portainer BE with Docker Swarm on WSL / Docker Desktop
      • Install Portainer BE with Docker Swarm on Windows Container Service
    • Kubernetes
      • Install Portainer BE on your Kubernetes environment
      • Install Portainer BE with Kubernetes on WSL / Docker Desktop
    • Initial setup
• Install Portainer CE
  • Set up a new Portainer CE Server installation
    • Docker Standalone
      • Install Portainer CE with Docker on Linux
      • Install Portainer CE with Docker on WSL / Docker Desktop
      • Install Portainer CE with Docker on Windows Container Service
    • Docker Swarm
      • Install Portainer CE with Docker Swarm on Linux
      • Install Portainer CE with Docker Swarm on WSL / Docker Desktop
      • Install Portainer CE with Docker Swarm on Windows Container Service
    • Kubernetes
      • Install Portainer CE on your Kubernetes environment
      • Install Portainer CE with Kubernetes on WSL / Docker Desktop
    • Initial setup
• Add an environment to an existing installation
  • Docker Standalone
    • Install Portainer Agent with Docker on Linux
    • Install Portainer Agent with Docker on WSL / Docker Desktop
    • Install Portainer Agent with Docker on Windows Container Service
  • Docker Swarm
    • Install Portainer Agent with Docker Swarm on Linux
    • Install Portainer Agent with Docker Swarm on WSL / Docker Desktop
    • Install Portainer Agent with Docker Swarm on Windows Container Service
  • Kubernetes
    • Import an existing Kubernetes environment
    • Install Portainer Agent on your Kubernetes environment
    • Install Portainer Agent with Kubernetes on WSL / Docker Desktop
  • Azure ACI
  • Nomad
  • KaaS
    • Civo
    • Linode
    • DigitalOcean
    • Google Cloud
    • AWS
    • Azure
  • Edge Agent
• Upgrading Portainer
  • Upgrading on Docker Standalone
  • Upgrading on Docker Swarm
  • Upgrading on Kubernetes
  • Upgrading on Nomad
  • Upgrading the Edge Agent
  • Switching to Portainer Business Edition
    • Upgrade to Business Edition from Portainer
    • Docker Standalone
    • Docker Swarm
    • Kubernetes
    • Upgrading Agent-only deployments

Using Portainer

• Home
• Docker/Swarm
  • Dashboard
  • App Templates
    • Custom templates
    • Deploy a stack
    • Deploy a container
  • Stacks
    • Add a new stack
    • Inspect or edit a stack
    • Create a template from a deployed stack
    • Webhooks
    • Migrate or duplicate a stack
    • Remove a stack
  • Services
    • Add a new service
    • Configure service options
    • Scale a service
    • View the status of a service task
    • View service logs
    • Roll back a service
    • Webhooks
  • Containers
    • Add a new container
    • View a container's details
    • Inspect a container
    • Edit or duplicate a container
    • Advanced container settings
    • Webhooks
    • Attach a volume to a container
    • View container logs
    • View container statistics
    • Access a container's console
    • Change container ownership
    • Remove a container
  • Images
    • Pull an image
    • Build a new image
    • Import an image
    • Export an image
  • Networks
    • Add a new network
    • Remove a network
  • Volumes
    • Add a new volume
    • Browse a volume
    • Remove a volume
  • Configs
    • Add a new config
    • Remove a config
  • Secrets
    • Add a new secret
    • Remove a secret
  • Events
  • Host
    • Setup
    • Registries
  • Swarm
    • Setup
    • Cluster visualizer
    • Registries
• Kubernetes
  • Dashboard
  • kubectl shell
  • Kubeconfig
  • Custom Templates
    • Add a new custom template
    • Edit a custom template
    • Remove a custom template
  • Namespaces
    • Add a new namespace
    • Manage a namespace
    • Manage access to a namespace
    • Remove a namespace
  • Helm
    • Deploy a new application from a Helm chart
  • Applications
    • Add a new application using a form
    • Add a new application using a manifest
    • Inspect an application
    • Edit an application
    • Webhooks
    • Detach a volume from an application
    • Remove an application
  • Ingresses
    • Add an Ingress manually
    • Add an Ingress using a manifest
    • Remove an Ingress
  • ConfigMaps & Secrets
    • Add a ConfigMap
    • Add a Secret
    • Remove a ConfigMap or Secret
  • Volumes
    • Inspect a volume
    • Remove a volume
  • Cluster
    • Setup
    • Inspect a node
    • Security constraints
    • Registries
• Azure ACI
  • Dashboard
  • Container instances
    • Add a new container
    • Remove a container
• Nomad
  • Dashboard
  • Nomad Jobs
• Edge Compute
  • Edge Groups
  • Edge Stacks
  • Edge Jobs
  • Waiting Room
• Account settings

Administering Portainer

• Users
  • Teams
    • Add a new team
    • Add a user to a team
  • Roles
  • Add a new user
  • Turn a user into an administrator
  • Reset a user's password
• Environments
  • Groups
  • Tags
  • Add a new environment
    • Add a local environment
    • Add a Docker Standalone environment
    • Add a Docker Swarm environment
    • Add a Kubernetes environment
    • Add an ACI environment
    • Add a Nomad environment
    • Add an Edge environment
    • Add an environment via the Portainer API
  • Manage access to environments
  • Manage access to environment groups
  • Update & Rollback
• Registries
  • Add a new registry
    • Add a DockerHub account
    • Add an AWS ECR registry
    • Add a Quay.io registry
    • Add a ProGet registry
    • Add an Azure registry
    • Add a Gitlab registry
    • Add a GitHub registry
    • Add a custom registry
  • Browse a registry
  • Manage a registry
• Licenses
• Authentication logs
  • Activity logs
• Notifications
• Settings
  • Authentication
    • Authenticate via LDAP
    • Authenticate via Active Directory
    • Authenticate via OAuth
  • Cloud
    • Add Civo credentials
    • Add Linode credentials
    • Add DigitalOcean credentials
    • Add Google Cloud credentials
    • Add AWS credentials
    • Add Azure credentials
  • Edge Compute
    • Edge Devices
      • FDO
      • OpenAMT

Frequently Asked Questions

• Portainer Concepts
• Installing
• Upgrading
• Troubleshooting
• Contributing

Advanced Topics

• CLI configuration options
• App templates
  • Build and host your own app templates
  • App template JSON format
• The Portainer Edge Agent
• Access control
• Reset the admin user's password
• Security and compliance
• Encrypting the Portainer database
• Using your own SSL certificate with Portainer
• Using Portainer with reverse proxies
  • Deploying Portainer behind Traefik Proxy
  • Deploying Portainer behind nginx reverse proxy
• Helm chart configuration options
• Kubernetes roles and bindings
• Deprecated and removed features

API

• Accessing the Portainer API
• API documentation
• API usage examples

Get More Help

• Knowledge Base
• YouTube
• Slack
• Discord
• Open a support request

Contribute to Portainer

• Contribute
• Build instructions
  • Set up a macOS build environment
  • Set up a Linux build environment