00_Recapitulatif

Vue d ensemble - VPS Jux + Claude Code

34 containers en production sur le VPS. 25 pages de documentation, une par service. 13 services disposent d un MCP actif dans Claude Code. Mis a jour le 2026-05-30.

Page	URL	MCP Claude Code	Statut integration
01_Portainer	https://portainer.juxjux.ovh	mcp__portainer__*	MCP actif
02_Bookstack	https://bookstack.juxjux.ovh	bookstack-mcp-server (npm)	MCP actif
03_Homarr	https://homarr.juxjux.ovh	mcp__homarr__*	MCP actif
04_Audiobookshelf	https://audiobookshelf.juxjux.ovh	mcp__audiobookshelf__*	MCP actif
05_BentoPDF	-	-	API directe
06_Cadvisor	-	-	via Prometheus
07_Calibre-web	-	-	OPDS
08_Dozzle	-	-	via Portainer MCP
09_FileBrowser	https://files.juxjux.ovh	mcp__filebrowser__*	MCP actif
10_FreshRSS	https://freshrss.juxjux.ovh	mcp__freshrss__*	MCP actif
11_Gitea	-	-	API REST directe
12_Grafana	https://grafana.juxjux.ovh	-	API REST directe
13_Immich	https://immich.juxjux.ovh	mcp__immich__*	MCP actif (5 containers)
14_Jellyfin	https://jellyfin.juxjux.ovh	mcp__jellyfin__*	MCP actif
15_Joplin	-	-	sync server uniquement
16_Kavita	https://kavita.juxjux.ovh	mcp__kavita__*	MCP actif
17_Komga	https://komga.juxjux.ovh	mcp__komga__*	MCP actif
18_Mealie	https://mealie.juxjux.ovh	mcp__mealie__*	MCP actif
19_Navidrome	https://navidrome.juxjux.ovh	mcp__navidrome__*	MCP actif
20_NodeExporter	-	-	via Prometheus
21_Prometheus	-	-	API REST / PromQL
22_Readeck	https://readeck.juxjux.ovh	mcp__readeck__*	MCP actif
23_Syncthing	https://syncthing.juxjux.ovh	mcp__syncthing__*	MCP actif
24_Yourls	-	-	API REST directe
25_StirlingPDF	https://spdf.juxjux.ovh	-	API directe
A_liens entre Claude et le KDRIVE	kdrive.infomaniak.com	@infomaniak/mcp-server-kdrive + API REST	MCP actif (kdrive_search) + API directe

Scripts de maintenance

fill_bookstack_pages.py	Remplit les pages avec les infos containers (image, ports, volumes)	C:\Users\eliob\.claude\fill_bookstack_pages.py
fill_bookstack_mcp.py	Ajoute la section integration Claude Code / MCP a chaque page	C:\Users\eliob\.claude\fill_bookstack_mcp.py

Configuration MCP

Scripts dans C:\Users\eliob\.claude\, enregistres dans C:\Users\eliob\.mcp.json. Projet Claude Code principal : C:\Users\eliob. Endpoint Portainer Docker local : ID 3.

260611-REX VPS par Claude

Releve du 2026-06-11 via Prometheus (PromQL sur localhost:9090) + Portainer MCP.

Etat global

RAM	8.4 / 11.41 GB (73.6%)
Swap	3.99 / 4.0 GB (quasi plein)
CPU	5.2%

Top consommateurs RAM (RSS)

Container	RAM RSS
komga	1059 MB
Immich-SERVER	1011 MB
Immich-MICROSERVICES	520 MB
stirling-pdf	442 MB
homarr2026	355 MB
jellyfin	272 MB
prometheus	259 MB
jdownloader	220 MB
Kavita	196 MB
joplin	179 MB
calibre-web-eyrolles	132 MB
mealie	129 MB
grafana	125 MB
cadvisor	91 MB
navidrome	86 MB

Swap sature : komga + Immich representent ~2.5 GB a eux deux. StirlingPDF (442 MB) reste charge entre les appels.

 

260801-REX VPS par Claude

Releve du 2026-08-01 via docker stats + /proc en SSH (PC eliob).

Etat global

RAM	8.2 / 11.41 GB (71.7%)
Swap	4.0 / 4.0 GB (sature a 100%)
CPU	28% (compression 7z du backup en cours)

Top consommateurs RAM (RSS)

Container	RAM RSS
Immich-SERVER	1147 MB
komga	791 MB
Immich-MICROSERVICES	618 MB
stirling-pdf	566 MB
jellyfin	380 MB
homarr2026	313 MB
Immich-DB	310 MB
prometheus	282 MB
joplin	241 MB
Kavita	240 MB
cadvisor	195 MB
grafana	164 MB
joplin-db	158 MB
yourls-db	157 MB
audiobookshelf	140 MB

Swap sature : komga (760 MB) + StirlingPDF (406 MB) en tete des processus swappes, Immich ~330 MB. Des limites memoire ont ete posees depuis juin sur les gros containers (komga 4.4G, Immich 2G, Kavita 4G, joplin 2G). Decouvertes du jour : GNOME/gdm3 tourne a vide sur tty1 depuis le 8 juillet (98 paquets installes, ~150 MB RAM, aucun acces distant configure) ; sauvegardes Immich vides depuis l'origine (pg_dump sans -d immich, archives de 4 Ko) — corrigees le 2026-08-01, dump reel 307 MB.

Actions realisees le 2026-08-01 (soir)

Action Detail Gain Fix backup Immich -d immich ajoute dans /opt/backups/vps_backup.sh + run manuel complet 5/5 OK (archive 87 MB sur kDrive, premiere sauvegarde Immich valide) donnees enfin sauvegardees Fusion Immich 5 containers → 3 : SERVER unique (API + workers, NODE_OPTIONS=--max-old-space-size=768), MICROSERVICES et LEARNING supprimes (recherche semantique et visages non utilises). Ancien compose : compose/29/docker-compose.yml.bak-260801 ~900 MB RAM Arret cAdvisor docker update --restart=no cadvisor + stop. Plus de metriques par container dans Prometheus/Grafana (node-exporter conserve le host) ~200 MB RAM + 4-8% CPU GDM/GNOME desactive puis purge gdm3 + gnome-shell + Xorg tournaient a vide sur tty1 depuis le 2026-07-08. systemctl disable --now gdm puis purge apt de 263 paquets (bureau complet + LibreOffice, jeux...). Verifie avant : ens3 gere par systemd-networkd, NetworkManager non critique. Verifie apres : 30 containers up, nginx/docker/ssh/wg actifs, sites en 200 ~150 MB RAM + 3,5 GB disque

Resultat global du 2026-08-01 : swap 4,0/4,0 GB (sature depuis juin) → 2,6/4,0 GB ; disque 62% → 59% ; ~1,3 GB de RAM liberes. Immich verifie fonctionnel par Julien.

Plan du 2026-08-02 a 19h (tache planifiee Claude Code)

Apres verification du backup nocturne (BILAN 5/5 OK), appliquer les deux fixes JVM prepares et valides (fichiers en attente dans /home/debian/) :

Service Avant Apres Gain attendu Komga (stack 7) -Xmx4g -Xms2g (2 GB pre-alloues, ~760 MB en swap), limites 4500M/3000M -Xmx1g sans Xms, limites 1500M/256M ~400-500 MB RAM + ~700 MB swap StirlingPDF (stack 89) JVM sans plafond (566-643 MB residents + ~406 MB swap) JAVA_TOOL_OPTIONS=-Xmx512m, limite 1g ~300-400 MB RAM

Verifications prevues : komga.juxjux.ovh en 200, test compress-pdf sur spdf.juxjux.ovh (fonction critique des workflows komga-pdf et geo_loud), docker stats, free -h (swap attendu sous ~2 GB). Rollback : restaurer les .bak-260802. Nota : BentoPDF n'existe plus sur le VPS (container supprime) — il ne peut de toute facon pas remplacer StirlingPDF (pas d'API serveur, traitement 100% navigateur).