Skip to main content

Portainer

Portainer Stacks​

Prerequisites​

Installing​

To install Homarr using Portainer Stacks, simply create a new stack and paste the following code into it.

docker-compose.yml
#---------------------------------------------------------------------#
#     Homarr - A simple, yet powerful dashboard for your server.      #
#---------------------------------------------------------------------#
services:
  homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # Optional, only if you want docker integration
      - <your-path>/appdata:/appdata
    environment:
      - SECRET_ENCRYPTION_KEY=your_64_character_hex_string # <--- can be generated with `openssl rand -hex 32`
    ports:
      - '7575:7575'
note

Portainer will mount the files to your host machine. Please make sure to replace <your-path> from the docker run command with your desired storage location. The path must be absolute.

Then, click on Deploy the stack and wait until the container has started.

tip

If you're unsure how to create a stack, checkout the Portainer Documentation.

Updating​

To update Homarr using Docker Compose or Portainer Stacks, simply pull the latest image and restart the container.

  1. Run docker pull ghcr.io/homarr-labs/homarr:latest to pull the latest image.
  2. Re-run docker-compose up -d or re-deploy the stack in Portainer.