Wafrn draaien op een gedeelde VPS: Caddy slim inpassen

Eén bericht, meerdere netwerken

De belofte van het fediverse spreekt veel mensen aan. Je plaatst iets één keer en bereikt tegelijk Mastodon, BlueSky en Lemmy. Wafrn maakt dat mogelijk met één dashboard. Maar de installatie gaat uit van een eigen server met Docker en Caddy als enige webserver. Dat botst als je al meerdere diensten draait op dezelfde VPS.

Waarom de standaardaanpak problemen geeft

Wafrn verwacht dat Caddy automatisch Let's Encrypt-certificaten regelt. Die certificaten zijn nodig voor ATProto-verificatie. Heb je al een webserver zoals Nginx op poort 443 draaien, dan ontstaat er een conflict. Twee servers kunnen niet dezelfde poort claimen, en certificaatbeheer wordt chaotisch als meerdere processen hetzelfde domein beheren.

Caddy als aparte laag

De oplossing is eenvoudig: laat je bestaande webserver staan en zet Caddy met Wafrn erachter als een aparte service. Je primaire reverse proxy (Nginx of iets anders) stuurt alleen de Wafrn-routes door naar het interne Caddy-exemplaar. Caddy regelt daarna zelf de certificaten die ATProto nodig heeft. Zo raak je je bestaande setup niet kwijt en voldoe je toch aan de eisen van het protocol.

Configuraties omzetten met AI

Nginx-configs omzetten naar Caddyfile gaat meestal soepel met AI-tools. Dat is grotendeels een formaatwisseling. Maar zodra het gaat over ATProto-certificaten, proxy-instellingen of debugging van federation-problemen, schiet AI tekort. Zulke keuzes vragen domeinkennis die modellen missen. Gebruik AI voor de vertaling, maar vertrouw er niet blind op voor architectuur.

Documenteer wat je leert

De meeste mensen die dit zelf proberen, stuiten op dezelfde hiaten in de documentatie. Deel je configuratie op GitHub of in de community. Daarmee bespaar je anderen uren zoekwerk en bouw je een bruikbare referentie op voor jezelf.

Praktische lessen

• ATProto-federatie vereist geldige certificaten voor je domein.
• De standaardinstallatie past niet altijd bij gedeelde hosting.
• Houd Caddy gescheiden van je hoofdserver.
• AI is handig voor conversies, maar ontwerp je infrastructuur zelf.
• Leg je oplossing vast zodat anderen ervan kunnen leren.

Dit patroon – een aparte proxy-laag voor protocol-specifieke eisen – werkt ook bij andere federatie-tools.