Homarr
Getting startedInstallation

Portainer

Install with a stack

Create a Portainer stack with this Compose file:

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"

Replace <your-path> with an absolute host path, generate SECRET_ENCRYPTION_KEY, then deploy the stack. See Portainer's stack documentation for Portainer-specific options.

Updating

Pull the current image and redeploy the stack:

  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.

On this page