Getting startedInstallation
Portainer
Install with a stack
Create a Portainer stack with this Compose file:
#---------------------------------------------------------------------#
# 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:
- Run
docker pull ghcr.io/homarr-labs/homarr:latestto pull the latest image. - Re-run
docker-compose up -dor re-deploy the stack in Portainer.