Homarr creates a customizable browser homepage that lets you manage and interact with Docker containers running on your homeserver. Here’s my dashboard setup:

hello there

Prerequisites

Installation

Append this configuration to your docker-compose.yml file:

  homarr:
      container_name: homarr
      image: ghcr.io/ajnart/homarr:latest
      restart: unless-stopped
      logging:
        driver: json-file
        options:
          max-file: ${DOCKERLOGGING_MAXFILE}
          max-size: ${DOCKERLOGGING_MAXSIZE}
      environment:
        - PUID=${PUID}
        - PGID=${PGID}
        - TZ=${TZ}
      volumes:
        - ${DOCKERCONFDIR}/homarr/configs:/app/data/configs
        - ${DOCKERCONFDIR}/homarr/icons:/app/public/icons
        - ${DOCKERCONFDIR}/homarr/data:/data
      ports:
        - 7575:7575

Start the container by running this command in your docker directory (typically /volume1/docker/appdata):

docker compose up -d

This launches Homarr in detached mode (running in the background).

Resources