---
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).
