Vos outils.
Vos données.
Votre serveur.

Un seul conteneur sert l'interface web d'Asgard Notes, la synchro par comptes et la synchro du coffre chiffré d'Asgard Remote. Il relaie aussi, si vous le configurez, le panneau Argos de Notes et les fonctions Argos de Remote. Chiffré en transit derrière votre reverse proxy. Image Docker Hub (amd64 · arm64)

1. 1 Le fichier compose.yml

   L'image est tirée du Docker Hub — rien à construire, aucun .env à remplir. Dans un dossier (ex. ~/asgard-notes) :

   services:
     asgard-notes-web:
       image: anpms/asgard-notes-web:latest
       container_name: asgard-notes-web
       restart: unless-stopped
       init: true
       environment:
         TZ: "Europe/Paris"
       ports:
         - "4321:4321"
       volumes:
         - asgard-web-data:/data
         # Facultatif — assistant Claude Code (Administration) :
         # - ${HOME}/.claude:/home/node/.claude
       read_only: true
       tmpfs: [/tmp]
       security_opt: [no-new-privileges:true]
       cap_drop: [ALL]
       user: "node"
       mem_limit: 512m
   
   volumes:
     asgard-web-data:

   Version complète et commentée : server/compose.yml du dépôt Asgard Notes.

2. 2 Lancer

   docker compose up -d

3. 3 Créer le compte administrateur

   Ouvrez l'adresse du serveur : au premier accès, l'écran propose de créer le compte administrateur. Tout le reste se règle ensuite dans Administration (icône bouclier de la barre de gauche) : connexions, reverse proxy, IP autorisées (facultatif), relais Asgard Argos, assistant Claude Code — appliqué sans redémarrage.

4. 4 HTTPS (reverse proxy)

   Le conteneur écoute en HTTP sur le port 4321 ; le TLS est terminé par votre proxy (Traefik, Nginx, Caddy), qui doit préserver l'en-tête Host, transmettre X-Forwarded-Proto/-For et autoriser l'upgrade WebSocket. Exemple Nginx :

   location / {
       proxy_pass http://<ip-hôte>:4321;
       proxy_set_header Host $host;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header X-Forwarded-For $remote_addr;
       proxy_http_version 1.1;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection "upgrade";
       proxy_read_timeout 3600s;
   }

   Avec un Traefik sur une autre machine (configuration par fichier) :

   [http.routers.notes]
     rule = "Host(`notes.mondomaine.fr`)"
     entryPoints = ["websecure"]
     service = "notes"
     [http.routers.notes.tls]
       certResolver = "letsencrypt"
   [[http.services.notes.loadBalancer.servers]]
     url = "http://<ip-hôte>:4321"

5. 5 Comptes & jetons de service

   Administration → Comptes : un compte par utilisateur. Le même compte sert à Asgard Notes (web, mobile, bureau) et au coffre d'Asgard Remote. Derrière Traefik, activez Derrière un reverse proxy (onglet Connexion et sécurité).

   Administration → Jetons de service : jetons svc_… sans expiration et révocables, pour un programme qui lit vos notes en continu (Asgard Argos, n8n, scripts). Le jeton n'est affiché qu'une fois.

Serveur en place ? Passez à l'étape 2 · Connecter les apps ↑