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)
cd /var/www/gnexus-auth && sudo git pull (fast-forward on master)
- Check
git diff --stat <old>..<new> -- composer.lock package.json package-lock.json database/migrations/ — if empty, no composer/npm/migrate needed (assets are committed to the repo)
- Align
.env with .env.example changes (e.g. SESSION_LIFETIME)
php artisan config:clear route:clear view:clear queue:restart
sudo systemctl restart php8.3-fpm (opcache reset)
- 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 (2nd update): updated be4aea0 → af9d3f9 (country selection at registration with timezone driven by country; auth screens centered at 420px). No deps/migrations needed. Caches cleared, php8.3-fpm restarted, queue worker active. Verified: /register 200 with new app-main-auth layout.
- 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).