Skip to content

Installer et déployer Homarr avec Docker

Objectif

Installer Homarr à l'aide de Docker et Docker-Compose sur un serveur Linux.

Prérequis

  • Serveur Debian ou Ubuntu.

  • Accès root ou sudo.

🔹 Si vous utilisez Portainer

  • Il suffit de coller la Stack suivante dans Portainer pour déployer Homarr :
version: '3'

services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
      - ./homarr/data:/data
    ports:
      - '7575:7575'

Pensez à ouvrir le port 7575 sur votre box/pare-feu.

1. Installer Docker-Compose (si besoin)

Vérifier ou installer Docker-Compose :

apt-get install docker-compose

2. Préparer les dossiers Homarr

Créer la structure de dossiers nécessaire :

mkdir -p ./homarr/configs
mkdir -p ./homarr/icons
mkdir -p ./homarr/data

Vérifier que les dossiers sont bien créés :

ls ./homarr

3. Créer le fichier docker-compose.yml

Créer un fichier compose :

nano docker-compose.yml

Ajouter le contenu suivant :

version: '3'

services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
      - ./homarr/data:/data
    ports:
      - '7575:7575'

Ouvrir le port 7575 sur la box/pare-feu si besoin.

4. Lancer Homarr

Démarrer le conteneur :

docker-compose up -d

Homarr sera accessible à :

http://192.168.X.X:7575

(Remplacer 192.168.X.X par l'adresse IP locale de votre serveur.)

5. Déploiement via Portainer (optionnel)

Copier le contenu de votre docker-compose.yml dans une Stack sur Portainer si vous préférez gérer vos conteneurs graphiquement.