diff --git a/10-systems/hosts/gnauth.md b/10-systems/hosts/gnauth.md new file mode 100644 index 0000000..96c760e --- /dev/null +++ b/10-systems/hosts/gnauth.md @@ -0,0 +1,46 @@ +--- +title: VM gnauth (gnexus-auth) +type: host +ip: 192.168.1.167 +purpose: Central identity service (gnexus-auth, Laravel) for the Gnexus platform +owner: gmikcon +status: active +confidence: 100 +last_reviewed: 2026-09-24 +review_interval: 90d +source_of_truth: ssh-host-and-live-verified +--- + +# VM gnauth (192.168.1.167) + +## Overview + +- **Hostname**: gnauth +- **IP**: 192.168.1.167 (home LAN) +- **OS**: Ubuntu 22.04.5 LTS, kernel 5.15.0-187-generic +- **Resources**: 2 vCPU, 3.8 GiB RAM +- **User**: ubuntu (sudo password in gnexus-creds secret `gnauth-gnbook-ssh`, id 11932ea2-998b-4b2c-a722-1bccc68454cd; same credentials also cover gnbook 192.168.1.170) +- **Hypervisor**: HP ProLiant DL380 G6 (192.168.1.130, bserv) — VM, per gnexus-creds secret notes + +## Service: gnexus-auth + +- **Stack**: Laravel (PHP 8.3 FPM) + nginx/1.18.0 + MySQL (system, 127.0.0.1:3306) +- **Code root**: `/var/www/gnexus-auth` (owned by www-data, git via sudo) +- **Public URL**: https://auth.gnexus.space/ (TLS terminates on internal-proxy-vps .226, proxy mapping auth.gnexus.space → http://192.168.1.167) +- **Repo**: https://git.gnexus.space/git/root/gnexus-auth.git (remote embeds root credentials) +- **Queue worker**: systemd unit `gnexus-auth-queue.service` (User=www-data) +- **Scheduler**: root cron `php artisan schedule:run` every minute +- **Deploy doc**: `/home/ubuntu/gnexus-auth-deployment.md` on the host + +## Deploy procedure (verified 2026-09-24) + +1. `cd /var/www/gnexus-auth && sudo git pull` (fast-forward on master) +2. Check `git diff --stat .. -- composer.lock package.json package-lock.json database/migrations/` — if empty, no composer/npm/migrate needed (assets are committed to the repo) +3. Align `.env` with `.env.example` changes (e.g. SESSION_LIFETIME) +4. `php artisan config:clear route:clear view:clear queue:restart` +5. `sudo systemctl restart php8.3-fpm` (opcache reset) +6. Verify: `curl http://127.0.0.1/` → 200, and public URL from outside (hairpin NAT blocks access from the host itself) + +## Deployment history + +- **2026-09-24**: updated b0f50ed → be4aea0 (app-shell layout, admin tabs in URL hash, HTTPS force outside local, web session 30 days / access token 30 minutes). SESSION_LIFETIME set to 43200 in .env. php8.3-fpm restarted, queue worker recovered (had been failed since 2026-09-01 due to transient MySQL outage).