Newer
Older
gnexus-book / 10-systems / hosts / gnauth.md

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 <old>..<new> -- 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 (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).