History

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
..
companion.lilith.apricot.local.conf	deploy(deployments): 🚀 Refactor and enhance deployment workflows in the deployments directory	2026-04-01 23:54:15 -07:00
README.md	deploy(deployments): 🚀 Refactor and enhance deployment workflows in the deployments directory	2026-04-01 23:54:15 -07:00

README.md

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