[{"data":1,"prerenderedAt":385},["ShallowReactive",2],{"\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fmises-a-jour":3,"section:\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fmises-a-jour":384},{"id":4,"title":5,"body":6,"description":369,"extension":370,"meta":371,"navigation":373,"path":380,"seo":381,"stem":382,"__hash__":383},"docs\u002F2.next\u002F5.administrer\u002F03.exploitation\u002F3.mises-a-jour.md","Mettre à jour un site auto-hébergé",{"type":7,"value":8,"toc":361},"minimark",[9,13,31,34,39,56,60,94,100,104,122,129,132,222,228,232,235,287,295,299,316,320,350,357],[10,11,5],"h1",{"id":12},"mettre-à-jour-un-site-auto-hébergé",[14,15,16],"blockquote",{},[17,18,19,20,25,26,30],"p",{},"S'applique à : auto-hébergé, mise à jour dans la même version majeure (par exemple v5.48 → v5.50). Pour changer de version majeure, voir ",[21,22,24],"a",{"href":23},"\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fmigration-v4-vers-v5","Migrer de la v4 à la v5",". Sur Dokos Cloud, voir ",[21,27,29],{"href":28},"\u002Fnext\u002Fadministrer\u002Fcloud\u002Fmettre-a-jour-un-site","Mettre à jour un site Dokos Cloud",".",[17,32,33],{},"Une mise à jour récupère le nouveau code des applications, installe les dépendances, exécute les patchs sur la base de données et recompile l'interface.",[35,36,38],"h2",{"id":37},"avant-de-commencer","Avant de commencer",[40,41,42,50,53],"ul",{},[43,44,45,46,30],"li",{},"Faites une sauvegarde complète et copiez-la hors du serveur. Voir ",[21,47,49],{"href":48},"\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fsauvegardes-et-restauration","Sauvegarder et restaurer",[43,51,52],{},"Si vous avez des applications personnalisées, testez la mise à jour sur un site de test d'abord.",[43,54,55],{},"Prévenez les utilisateurs. Le site passe en mode maintenance pendant les patchs.",[35,57,59],{"id":58},"mettre-à-jour-avec-docker","Mettre à jour avec Docker",[61,62,63,70,76,82,88],"ol",{},[43,64,65,66,30],{},"Si vous changez de version d'image, modifiez le numéro de version dans le fichier ",[67,68,69],"code",{},"compose.yaml",[43,71,72,73,30],{},"Téléchargez les nouvelles images : ",[67,74,75],{},"docker compose pull",[43,77,78,79,30],{},"Arrêtez les conteneurs : ",[67,80,81],{},"docker compose down",[43,83,84,85,30],{},"Démarrez les conteneurs : ",[67,86,87],{},"docker compose up -d",[43,89,90,91,30],{},"Migrez les sites : ",[67,92,93],{},"docker compose run backend bench --site all migrate",[17,95,96,97,99],{},"Arrêtez toujours les conteneurs avec ",[67,98,81],{}," avant de les redémarrer. Sinon, le bureau peut rester vide après la mise à jour.",[35,101,103],{"id":102},"mettre-à-jour-avec-bench","Mettre à jour avec bench",[61,105,106,112],{},[43,107,108,109,30],{},"Placez-vous dans le dossier du bench, par exemple ",[67,110,111],{},"cd ~\u002Fdokos-bench",[43,113,114,115,118,119,30],{},"Lancez ",[67,116,117],{},"bench update --restart-supervisor",". Sur une installation qui utilise systemd, utilisez ",[67,120,121],{},"--restart-systemd",[17,123,124,125,128],{},"Sans option, ",[67,126,127],{},"bench update"," fait, dans cet ordre : une sauvegarde des sites, la récupération du code, l'installation des dépendances, la compilation de l'interface, les patchs, puis le redémarrage.",[17,130,131],{},"Vous pouvez lancer une seule de ces étapes :",[133,134,135,148],"table",{},[136,137,138],"thead",{},[139,140,141,145],"tr",{},[142,143,144],"th",{},"Option",[142,146,147],{},"Effet",[149,150,151,162,172,182,192,202,212],"tbody",{},[139,152,153,159],{},[154,155,156],"td",{},[67,157,158],{},"--pull",[154,160,161],{},"Récupère le code de toutes les applications",[139,163,164,169],{},[154,165,166],{},[67,167,168],{},"--apps \u003Capplication>",[154,170,171],{},"Limite la mise à jour aux applications indiquées",[139,173,174,179],{},[154,175,176],{},[67,177,178],{},"--requirements",[154,180,181],{},"Installe les dépendances Python et Node.js",[139,183,184,189],{},[154,185,186],{},[67,187,188],{},"--build",[154,190,191],{},"Compile les fichiers JS et CSS",[139,193,194,199],{},[154,195,196],{},[67,197,198],{},"--patch",[154,200,201],{},"Exécute les patchs sur tous les sites du bench",[139,203,204,209],{},[154,205,206],{},[67,207,208],{},"--reset",[154,210,211],{},"Réinitialise les dépôts git sur la branche suivie et supprime les modifications locales",[139,213,214,219],{},[154,215,216],{},[67,217,218],{},"--no-backup",[154,220,221],{},"Ne fait pas de sauvegarde avant la mise à jour. Déconseillé en production",[17,223,224,225,227],{},"Utilisez ",[67,226,208],{}," si la mise à jour s'arrête sur un conflit git. Cela arrive quand des fichiers standard ont été modifiés en mode développeur. Les modifications locales du code sont perdues.",[35,229,231],{"id":230},"exemple","Exemple",[17,233,234],{},"L'administrateur de Dokompany met à jour son bench en v5 un samedi matin :",[236,237,242],"pre",{"className":238,"code":239,"language":240,"meta":241,"style":241},"language-sh shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","cd ~\u002Fdokos-bench\nbench --site dokompany.fr backup --with-files\nbench update --restart-supervisor\n","sh","",[67,243,244,257,276],{"__ignoreMap":241},[245,246,249,253],"span",{"class":247,"line":248},"line",1,[245,250,252],{"class":251},"s2Zo4","cd",[245,254,256],{"class":255},"sfazB"," ~\u002Fdokos-bench\n",[245,258,260,264,267,270,273],{"class":247,"line":259},2,[245,261,263],{"class":262},"sBMFI","bench",[245,265,266],{"class":255}," --site",[245,268,269],{"class":255}," dokompany.fr",[245,271,272],{"class":255}," backup",[245,274,275],{"class":255}," --with-files\n",[245,277,279,281,284],{"class":247,"line":278},3,[245,280,263],{"class":262},[245,282,283],{"class":255}," update",[245,285,286],{"class":255}," --restart-supervisor\n",[17,288,289,290,294],{},"La commande se termine sans erreur. Il ouvre ",[291,292,293],"strong",{},"Aide > À propos"," et voit la nouvelle version de Dokos.",[35,296,298],{"id":297},"vérifier","Vérifier",[40,300,301,306,309],{},[43,302,303,305],{},[291,304,293],{}," affiche les versions attendues.",[43,307,308],{},"Vous ouvrez une facture, un client et un article sans erreur.",[43,310,311,312,30],{},"Le planificateur tourne : voir ",[21,313,315],{"href":314},"\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fdiagnostic","Diagnostiquer un site",[35,317,319],{"id":318},"si-la-mise-à-jour-échoue","Si la mise à jour échoue",[40,321,322,328,340,343],{},[43,323,324,325,30],{},"Si le site reste en maintenance, lancez ",[67,326,327],{},"bench --site dokompany.fr set-maintenance-mode off",[43,329,330,331,337,338,30],{},"Si un patch échoue, notez le message complet. Publiez-le sur le ",[21,332,336],{"href":333,"rel":334},"https:\u002F\u002Fcommunity.dokos.io",[335],"nofollow","forum de la communauté",". Après la correction, relancez ",[67,339,127],{},[43,341,342],{},"Avant de signaler un problème, refaites la mise à jour sur un bench sans application personnalisée. Cela montre si l'une d'elles bloque la mise à jour.",[43,344,345,346,30],{},"Voir aussi ",[21,347,349],{"href":348},"\u002Fnext\u002Fresoudre\u002Fmise-a-jour-et-migration\u002Fmise-a-jour-en-echec","Une mise à jour a échoué",[17,351,352,353,30],{},"Pour couper les emails, les notifications et les paiements automatiques d'un site (par exemple une copie de test), voir ",[21,354,356],{"href":355},"\u002Fnext\u002Fadministrer\u002Fcloud\u002Fsite-de-test","Copier la production sur un site de test",[358,359,360],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":241,"searchDepth":248,"depth":259,"links":362},[363,364,365,366,367,368],{"id":37,"depth":259,"text":38},{"id":58,"depth":259,"text":59},{"id":102,"depth":259,"text":103},{"id":230,"depth":259,"text":231},{"id":297,"depth":259,"text":298},{"id":318,"depth":259,"text":319},"Mettez à jour Dokos dans la même version majeure, avec Docker ou avec bench, puis vérifiez le site.","md",{"icon":372,"reviewed":373,"last_verified":374,"sources":375},"i-lucide-refresh-cw",true,"2026-10-31",[376,377,378,379],"dokos-cli 2.9.0 (bench update --help)","content\u002F*\u002F5.administrer\u002F02.installation\u002F2.docker.md","apps\u002Ffrappe\u002Ffrappe\u002F__init__.py (develop, mute_emails)","apps\u002Ferpnext\u002Ferpnext\u002Faccounts\u002Fdoctype\u002Fpayment_request\u002Fpayment_request.py (develop, mute_payment_gateways)","\u002Fnext\u002Fadministrer\u002Fexploitation\u002Fmises-a-jour",{"title":5,"description":369},"2.next\u002F5.administrer\u002F03.exploitation\u002F3.mises-a-jour","lVb48hyz95I84T8NZVONGpEpwe3MybEGsFdm16QWJ3M",{},1793871717455]