Bevindingen

De kracht van backups, en hoe je ze automatisch laat lopen

Hoe langer je met Hermes werkt, hoe meer er in je opstelling zit dat je niet opnieuw kan typen: je profielen, je geheugen, je gesprekken, je skills, je geplande taken en je instellingen. De vraag die erbij hoort is simpel. Als deze computer morgen stuk is, hoeveel moet je dan opnieuw opbouwen?

Het antwoord wordt elke week groter, en daarom is een backup geen klusje voor later. De lesversie van dit onderwerp staat in Backups, waarom je opstelling een kopie verdient.

Wat er in een backup zit

hermes backup maakt één zip van je hele Hermes-map. Daarin zit wat je zelf hebt opgebouwd:

  • je configuratie, inclusief de sleutels in .env en de authenticatie
  • je profielen, met hun persoonlijkheid en hun eigen instellingen
  • je geheugen, dus de notities die in elk gesprek worden meegeladen
  • je gesprekken, in de database
  • je skills en je plugins
  • je geplande taken, dus je cronjobs

Wat er niet in zit, en dat is met opzet: de Hermes-code zelf (die haal je opnieuw op), gedownloade modelbestanden en runtimes (samen vaak tientallen gigabytes, en opnieuw te downloaden), en de checkpoints van lopende sessies. Ook je browserprofielen blijven eruit, want daar zit je login van andere sites in.

De commando's

hermes backup

Dat schrijft een zip naar je thuismap, met een naam als hermes-backup-<tijdstip>.zip. Wil je hem ergens anders, dan geef je een pad mee met -o.

hermes backup --quick

Een snelle momentopname van alleen het kritieke: configuratie, de database, .env, de auth en de cronjobs. Veel sneller, en genoeg als je vooral je instellingen wil veiligstellen voor je iets groots verandert.

hermes backup --keep 3

Na een volledige backup ruimt hij oude zips op en houdt hij de nieuwste drie. Zonder die vlag is de standaard ook drie, en met --keep 0 bewaar je alles. Backups die je zelf een andere naam gaf, blijven altijd staan.

hermes import

Terugzetten. Dat is de reden dat je dit doet: een zip die je nooit kan openen is geen backup.

Automatisch, zonder kosten

Een backup waaraan je zelf moet denken, gebeurt niet. Hermes kan een script op een schema laten lopen zonder dat er een model aan te pas komt: geen tokens, geen kosten, geen gesprek dat ergens verschijnt.

hermes cron create "every day at 3am" \
  --no-agent \
  --script backup.sh \
  --deliver local \
  --name "hermes-backup"

Dat heet de no-agent modus: het script draait, en wat het naar buiten schrijft wordt als resultaat doorgegeven. Dezelfde cron kan ook gewoon in het Nederlands worden aangemaakt door erom te vragen, en dan maakt Hermes de job zelf aan.

Eén detail dat het verschil maakt tussen een backup en een vermoeden: hermes backup eindigt alleen met status nul als elk bestand in het archief zat. Bij een gedeeltelijke backup blijft de zip staan, maar het commando meldt een fout. Een geplande taak die dat als succes rapporteert, heeft niets opgelost. Kijk dus naar de uitkomst van de job, niet alleen naar het feit dat hij gelopen heeft.

Eén kopie buiten deze machine

Een backup op dezelfde schijf als het origineel is geen backup. Zet minstens één zip ergens anders:

  • een cloudmap die je al hebt, zoals OneDrive of Google Drive
  • een NAS of een externe schijf
  • objectopslag zoals Cloudflare R2
  • een versleutelde bestemming via iets als rclone

GitHub is een geval apart. Een private repo is prima voor de dingen die je opnieuw opbouwt: je SOUL.md, je skills, je scripts en een configuratie zonder sleutels. Maar een volledige Hermes-zip hoort daar niet, want daar zit alles in wat iemand die de zip heeft toegang geeft tot jouw installatie.

Behandel die zip als gevoelig

In een volledige backup zitten je API-sleutels, je .env, je auth.json, je gesprekken en je geheugen. Dat is precies wat een backup nuttig maakt, en precies waarom je er niet slordig mee omgaat. Zet hem niet in een gedeelde map, stuur hem niet door in een chat, en noem een link naar de zip nooit in een notitie die anderen kunnen lezen.

Waar het misgaat bij het terugzetten

Een backup terugzetten terwijl Hermes nog draait, is de klassieke fout. Stop elk Hermes-proces voor je iets vervangt, en kopieer de database nooit met de hand uit de zip: gebruik hermes import, dat de bestanden op de juiste manier terugzet.

En de vraag die je vooraf moet stellen: heb je ooit geoefend met terugzetten? Een backup die nooit getest is, is een aanname.

Wat ik zelf zou doen

  1. Vandaag één volledige backup maken, en kijken hoe groot de zip is.
  2. Die zip naar een schijf of cloudmap buiten deze computer kopiëren.
  3. Een wekelijkse cronjob zetten met --no-agent, zodat het niet meer van mijn geheugen afhangt.
  4. Eén keer een restore oefenen op een lege map, zodat ik weet dat het werkt voor ik het nodig heb.

Bronnen

  • De documentatie van hermes backup in de installatie: reference/cli-commands.md, met de opties --output, --quick, --label en --keep, en de uitleg over de exitstatus
  • user-guide/features/cron.md, over de no-agent modus met --script
  • user-guide/session-storage-recovery.md, over terugzetten met alles gestopt
← Alles uit de vaultVul de intake in →