--- title: "Portainer" description: "Portainer is a built-in integration for Home Assistant. It has 2.1k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/portainer" url: "https://vulpo.app/integrations/core/portainer.md" last-updated: "2026-10-22" version: "1.4" --- # Portainer > Portainer is a built-in integration for Home Assistant. It has 2.1k installs sharing analytics and works locally. Portainer is a built-in integration that connects Home Assistant to a Portainer instance to monitor and control Docker containers. It connects locally using an API access token, the instance URL with its port, and an option to turn off SSL certificate verification for self-signed certificates. It adds binary sensors, sensors, switches, buttons, events and update entities for containers, stacks and endpoints. Buttons can pause, resume, restart, kill or recreate a container, update a stack, and prune unused images or volumes. Recreating a container is more disruptive than a restart, since the container is stopped, removed and rebuilt with the same configuration. New devices appear automatically, removed ones are cleaned up, and connection settings can be changed without removing the integration. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=portainer) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Adds new devices**: New devices show up without setting it up again. - **Cleans up devices**: Devices that are gone are removed by themselves. - **Change settings later**: Its connection settings can change without removing it. - **Platinum quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up It is added under Settings, Devices and services, with Add integration. ### Connect - **API token**: The API access token for authenticating with Portainer - **URL**: The URL, including the port, of your Portainer instance - **Verify SSL certificate**: Whether to verify SSL certificates. Disable only if you have a self-signed certificate Also asked when changing the connection. ### Sign in again - **API token**: The new API access token for authenticating with Portainer Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Out of memory, Status - **Buttons**: Prune unused images, Kill container, Pause container, Recreate container, Restart container, Resume container, Update stack, Prune unused volumes - **Events**: Docker event - **Sensors**: API version, Architecture, Container disk usage reclaimable, Container disk usage total size, Health, Restart count, Started, State, Container count, Containers paused, Containers running, Containers stopped, and 21 more - **Switches**: Container, Stack - **Updates**: Image update available ## Actions - **Prune unused images**: Prunes unused images on a Portainer endpoint. Fields: Dangling, Endpoint, Until - **Recreate container**: Recreates a container on a Portainer endpoint. This is more disruptive than a restart as the container will be stopped, removed, and then re-created with the same configuration. Use with caution. Fields: Container, Pull image, Timeout ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **System health**: Adds its status to Home Assistant's system information. ## At a glance - Kind: Built-in integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), NAS and servers - Brand: [Portainer](https://vulpo.app/integrations/portainer.md) - Number: 2.1k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Platinum quality scale - Domain: `portainer` - Source: In Vulpo: Quick Toggle card, Button card, Chart card, Apple Watch, Control Center ## Other ways in for Portainer | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Portainer Swarm Monitor](https://github.com/m4rkireland/ha-portainer-swarm-monitor) | Marketplace integration | 1 installs sharing analytics | Works locally | Updated in the last 6 months | | [Portainer](https://vulpo.app/integrations/apps/portainer.md) | App | 2.3k installs sharing analytics | Connection not stated | Updated in the last 6 months | | [Portainer Agent](https://github.com/alexbelgium/hassio-addons) | App | 236 installs sharing analytics | Connection not stated | Updated in the last 6 months | | [Portainer Business Edition](https://github.com/alexbelgium/hassio-addons) | App | 7 installs sharing analytics | Connection not stated | Updated in the last 6 months | | [Portainer](https://github.com/tomaae/homeassistant-portainer) | Marketplace integration | 265 installs sharing analytics | Works locally | Removed from the Marketplace: Repository is archived | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/portainer --- - HTML version of this page: https://vulpo.app/integrations/core/portainer - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml