Repository files, collaboration, releases and project activity.
ARCHFORGE HISTORY
Blame · DEBIAN-13-INSTALL.md
Branch main · the Commit author is not necessarily a verified ArchForge account.
e59b7f7cc6archadmin2026-10-11
1 # Debian 13 installation — quick referencee59b7f7cc6archadmin2026-10-11
2 2109dd33b8archadmin2026-10-12
3 1. Create a ArchForge repository on ArchForge and push this ZIP's extracted source. Keep `.env` **out of ArchForge**.e59b7f7cc6archadmin2026-10-11
4 2. Set the DNS `A` record for `status.archforge.nl` to the **second** VPS public IP; open inbound TCP 80 and 443.e59b7f7cc6archadmin2026-10-11
5 3. Connect to Debian 13 VPS 2 via SSH:e59b7f7cc6archadmin2026-10-11
6 e59b7f7cc6archadmin2026-10-11
7 ```bashe59b7f7cc6archadmin2026-10-11
8 sudo apt-get update && sudo apt-get install -y gite59b7f7cc6archadmin2026-10-11
9 git clone <CLONE_URL_FROM_YOUR_ARCHFORGE_REPO> archforge-external-statuse59b7f7cc6archadmin2026-10-11
10 cd archforge-external-statuse59b7f7cc6archadmin2026-10-11
11 chmod +x install.she59b7f7cc6archadmin2026-10-11
12 sudo ./install.she59b7f7cc6archadmin2026-10-11
13 ```e59b7f7cc6archadmin2026-10-11
14 e59b7f7cc6archadmin2026-10-11
15 4. Follow the wizard. Specify targets, optionally add Discord and SMTP and **pair your admin authenticator** (6-digit TOTP). Real secrets are generated in `/etc/archforge-status/status.env` and not committed.e59b7f7cc6archadmin2026-10-11
16 5. Test `https://status.archforge.nl`, `https://status.archforge.nl/admin/login`, and `sudo systemctl status archforge-status`.e59b7f7cc6archadmin2026-10-11
17 6. Make controlled test requests and verify you receive independent outage and recovery notifications before relying on the service.2109dd33b8archadmin2026-10-12
18 7. Future releases: run `./update.sh` **as the ArchForge checkout owner**. `./backup.sh`, `./rollback.sh` and `./restore.sh` are provided.e59b7f7cc6archadmin2026-10-11
19 e59b7f7cc6archadmin2026-10-11
20 **Troubleshooting:** `sudo journalctl -u archforge-status -n 80 --no-pager`; `sudo journalctl -u caddy -n 80 --no-pager`; `curl -fsS http://127.0.0.1:3000/healthz`.e59b7f7cc6archadmin2026-10-11
21 e59b7f7cc6archadmin2026-10-11
22 **Offline main website?** The already-installed status server still works. `git pull` cannot fetch from the down main website until it returns, but monitoring is not interrupted.e59b7f7cc6archadmin2026-10-11
23 e59b7f7cc6archadmin2026-10-11
24 Full documentation: `README.md`.f1897d33c0archadmin2026-10-11
25 f1897d33c0archadmin2026-10-11
26 f1897d33c0archadmin2026-10-11
27 ## If the admin installer stops after entering your username (v1.0.0)f1897d33c0archadmin2026-10-11
28 2109dd33b8archadmin2026-10-12
29 Update your ArchForge checkout with version 1.0.1, then run from the checkout on Debian 13:f1897d33c0archadmin2026-10-11
30 f1897d33c0archadmin2026-10-11
31 ```bashf1897d33c0archadmin2026-10-11
32 # As rootf1897d33c0archadmin2026-10-11
33 bash ./recover-admin.shf1897d33c0archadmin2026-10-11
34 # Or use sudo bash ./recover-admin.sh from an ordinary user.f1897d33c0archadmin2026-10-11
35 ```f1897d33c0archadmin2026-10-11
36 f1897d33c0archadmin2026-10-11
37 The repair script updates the installed `src/cli.js` and resumes only the admin wizard. It does not delete or modify the existing configuration, SQLite database, or active statusserver. Password text is deliberately not shown while typing, then press Enter; use an authenticator app for the TOTP secret and enter the current six-digit code. See `HOTFIX-ADMIN-1.0.1.md`.b8619f148earchadmin2026-10-11
38 b8619f148earchadmin2026-10-11
39 ## Bestaande installatie: domein/SSL opnieuw instellen (v1.0.2)b8619f148earchadmin2026-10-11
40 2109dd33b8archadmin2026-10-12
41 Na het pushen naar ArchForge: `git pull --ff-only`, daarna `sudo bash ./configure-domain.sh` op Debian VPS 2. Hiervoor hoef je niets te verwijderen of opnieuw te installeren. De wizard vraagt de hostnaam, het publieke VPS 2 IP en optioneel een ACME e-mailadres. Hij controleert DNS, valideert Caddy en rapporteert of de HTTPS-certificaatcontrole echt is geslaagd. Zie `DOMAIN-SSL-DEBIAN-13.md`.