projects/companion
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
companion/@deployments/nginx/README.md
Claude Code e455bc3990 deploy(deployments): 🚀 Refactor and enhance deployment workflows in the deployments directory 
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
2026-04-01 23:54:15 -07:00

1.3 KiB
Raw Blame History

@companion nginx configuration

Installation

# Symlink into nginx sites-enabled:
sudo ln -sf "$(pwd)/companion.lilith.apricot.local.conf" /etc/nginx/sites-enabled/companion.lilith.apricot.local.conf

# Verify config and reload:
sudo nginx -t && sudo systemctl reload nginx

Domains

Domain Upstream Port
companion.lilith.apricot.local companion-api (NestJS) 3850
companion-web.lilith.apricot.local companion-web (Vite) 5850

SSL Certificates

Uses existing wildcard cert for *.lilith.apricot.local:

/etc/nginx/certs/local/_wildcard.lilith.apricot.local+1.pem
/etc/nginx/certs/local/_wildcard.lilith.apricot.local+1-key.pem

If the cert doesn't exist yet, generate with mkcert:

mkcert -install
mkcert -cert-file /etc/nginx/certs/local/_wildcard.lilith.apricot.local+1.pem \
       -key-file /etc/nginx/certs/local/_wildcard.lilith.apricot.local+1-key.pem \
       "*.lilith.apricot.local" lilith.apricot.local

Voice WebSocket Notes

  • proxy_buffering off is mandatory for the /voice/ location
  • PCM binary frames must not be buffered — any buffering causes audio glitches
  • proxy_read_timeout 3600s supports 1-hour voice sessions
  • The $connection_upgrade map must be in the nginx http context (nginx.conf)