Repository files, collaboration, releases and project activity.
ARCHFORGE HISTORY
Blame · DOMAIN-SSL-DEBIAN-13.md
Branch main · the Commit author is not necessarily a verified ArchForge account.
b8619f148earchadmin2026-10-11
1 # Domein en HTTPS instellen — Debian 13 (bestaande installatie)b8619f148earchadmin2026-10-11
2 b8619f148earchadmin2026-10-11
3 De nieuwe wizard koppelt `status.archforge.nl` aan de **tweede VPS** en configureert Caddy om automatisch een Let's Encrypt- of ander publiek vertrouwd ACME-TLS-certificaat aan te vragen. Je hoeft geen `certbot` te installeren of handmatig certificaten te genereren. Caddy verzorgt automatische vernieuwing.b8619f148earchadmin2026-10-11
4 b8619f148earchadmin2026-10-11
5 ## 1. DNS bij je providerb8619f148earchadmin2026-10-11
6 b8619f148earchadmin2026-10-11
7 Maak dit record aan (niet het IP van de hoofdwebsite):b8619f148earchadmin2026-10-11
8 b8619f148earchadmin2026-10-11
9 | Type | Naam | Waarde |b8619f148earchadmin2026-10-11
10 | --- | --- | --- |b8619f148earchadmin2026-10-11
11 | A | `status` | Publiek IPv4-adres van **VPS 2** |b8619f148earchadmin2026-10-11
12 b8619f148earchadmin2026-10-11
13 Een `AAAA`-record gebruik je alleen als de **tweede VPS** bereikbaar is via dat IPv6-adres. Verwijder oude/verkeerde A- en AAAA-records. Bij proxyproviders (zoals Cloudflare) is **DNS-only** het eenvoudigst voor directe verificatie. Een proxied DNS-record geeft het proxy-IP terug en wordt door de wizard bewust geweigerd: hij kan dan de bestemming niet betrouwbaar verifiëren.b8619f148earchadmin2026-10-11
14 b8619f148earchadmin2026-10-11
15 Open bij de VPS-provider én eventuele Debian-firewall TCP **80 en 443**. Voor SSH blijft je bestaande SSH-poort bereikbaar. De Node.js-app hoort **niet** rechtstreeks publiek op poort 3000 te luisteren.b8619f148earchadmin2026-10-11
16 b8619f148earchadmin2026-10-11
17 ## 2. Eerst code in Git updatenb8619f148earchadmin2026-10-11
18 b8619f148earchadmin2026-10-11
19 Plaats de bestanden van de 1.0.2-FULL-ZIP in de bestaande ArchForge Git-repository (geen `.env`/SQLite toevoegen), commit en push. Op VPS 2:b8619f148earchadmin2026-10-11
20 b8619f148earchadmin2026-10-11
21 ```bashb8619f148earchadmin2026-10-11
22 cd ~/archforge-external-statusb8619f148earchadmin2026-10-11
23 git pull --ff-onlyb8619f148earchadmin2026-10-11
24 ls -l configure-domain.shb8619f148earchadmin2026-10-11
25 ```b8619f148earchadmin2026-10-11
26 b8619f148earchadmin2026-10-11
27 **Ben je root?** `git pull` mag als root als deze bestaande checkout daadwerkelijk van root is, maar meng geen gebruikers of sudo in dezelfde checkout. De SSL-wizard vereist root-rechten. Je hoeft `./update.sh` of `./install.sh` niet opnieuw uit te voeren voor deze losse wizard.b8619f148earchadmin2026-10-11
28 b8619f148earchadmin2026-10-11
29 ## 3. Domain/SSL-wizardb8619f148earchadmin2026-10-11
30 b8619f148earchadmin2026-10-11
31 ```bashb8619f148earchadmin2026-10-11
32 sudo bash ./configure-domain.shb8619f148earchadmin2026-10-11
33 ```b8619f148earchadmin2026-10-11
34 b8619f148earchadmin2026-10-11
35 Als je als root bent ingelogd, kan dit ook gewoon met `bash ./configure-domain.sh`. De wizard vraagt:b8619f148earchadmin2026-10-11
36 b8619f148earchadmin2026-10-11
37 1. Het statusdomein (bijv. `status.archforge.nl`).b8619f148earchadmin2026-10-11
38 2. Het **publieke IPv4-adres van VPS 2**; dit moet overeenkomen met het DNS A-record.b8619f148earchadmin2026-10-11
39 3. Optioneel het werkelijke publieke IPv6-adres van VPS 2; een bestaand verkeerd AAAA-record wordt geweigerd.b8619f148earchadmin2026-10-11
40 4. Een optioneel e-mailadres voor ACME-certificaatmeldingen.b8619f148earchadmin2026-10-11
41 5. Toestemming om waar nodig actieve UFW-regels voor TCP 80/443 open te zetten.b8619f148earchadmin2026-10-11
42 6. `ENABLE` als expliciete bevestiging voor configuratiewijzigingen.b8619f148earchadmin2026-10-11
43 b8619f148earchadmin2026-10-11
44 De wizard valideert DNS **voordat** Caddy of de app-configuratie wordt gewijzigd. Bij onjuiste DNS stopt hij met aanwijzingen. Hij bewaart de oude Caddyconfiguratie en status.env tijdelijk en herstelt die bij een Caddy-validatie- of servicefout.b8619f148earchadmin2026-10-11
45 b8619f148earchadmin2026-10-11
46 Opmerking: als je op één VPS meerdere websites via Caddy host, controleer vóór aanpassing de bestaande `/etc/caddy/Caddyfile` en mogelijke dubbele domeinregistraties. Er wordt geen Caddyconfiguratie van andere websites doelbewust vervangen.b8619f148earchadmin2026-10-11
47 b8619f148earchadmin2026-10-11
48 ## 4. Controleer de echte SSL-uitgifteb8619f148earchadmin2026-10-11
49 b8619f148earchadmin2026-10-11
50 ```bashb8619f148earchadmin2026-10-11
51 systemctl status caddy --no-pagerb8619f148earchadmin2026-10-11
52 systemctl status archforge-status --no-pagerb8619f148earchadmin2026-10-11
53 curl -Iv https://status.archforge.nlb8619f148earchadmin2026-10-11
54 curl -fsS https://status.archforge.nl/healthzb8619f148earchadmin2026-10-11
55 journalctl -u caddy -n 80 --no-pagerb8619f148earchadmin2026-10-11
56 ```b8619f148earchadmin2026-10-11
57 b8619f148earchadmin2026-10-11
58 De wizard rapporteert **geverifieerde TLS** alleen als een echte HTTPS-call via de lokale Caddy met een vertrouwd certificaat en werkend `/healthz` lukt. Als de uitgifte nog loopt, meldt hij **NOT YET VERIFIED**: dat is geen garantie dat TLS klaar is. Controleer DNS, poorten, firewall, Caddy-logs en probeer de test opnieuw.b8619f148earchadmin2026-10-11
59 b8619f148earchadmin2026-10-11
60 Bij problemen met `dig`: `apt-get install -y dnsutils`. Bij een ontbrekende Caddy-installatie: `apt-get install -y caddy`. Een echte Debian 13 VPS is nodig om publiek ACME-certificaatbeheer te testen.b8619f148earchadmin2026-10-11
61 b8619f148earchadmin2026-10-11
62 ## Wat blijft behouden?b8619f148earchadmin2026-10-11
63 b8619f148earchadmin2026-10-11
64 - `/var/lib/archforge-status/status.db`: SQLite, monitoringgeschiedenis, admin en 2FA.b8619f148earchadmin2026-10-11
65 - `/etc/archforge-status/status.env`: alle bestaande geheimen en instellingen behalve `STATUS_PUBLIC_URL`.b8619f148earchadmin2026-10-11
66 - `/etc/archforge-status/msmtprc`: SMTP-configuratie.b8619f148earchadmin2026-10-11
67 - `archforge.nl` en zijn bestaande webproject: geen wijziging.b8619f148earchadmin2026-10-11
68 b8619f148earchadmin2026-10-11
69 ### Let opb8619f148earchadmin2026-10-11
70 b8619f148earchadmin2026-10-11
71 Een HTTPS-certificaat bewijst alleen dat het domein via TLS bereikbaar is. Het zegt niet dat de hoofdsite zelf online is; juist daarvoor draait de externe monitoring onafhankelijk.