Project_Animatix/Docs/RUNBOOK.md

Animatrix Runbook

Production Runtime

• frontend: 127.0.0.1:3200
• backend: 127.0.0.1:8200
• public hostname: animatrix.desineuron.in
• Comfy dependency: https://comfy.desineuron.in
• frontend service root: /opt/animatrix/frontend/.next/standalone
• backend env should include BACKEND_BASE_URL=https://animatrix.desineuron.in

Frontend Build Packaging

The frontend is deployed using Next.js standalone output. After every build, static assets must be copied into the standalone directory or the site will render unstyled because /_next/static/css/* will 404.

Required packaging flow:

cd /opt/animatrix
./scripts/build_frontend_standalone.sh
sudo systemctl restart animatrix-frontend
sudo systemctl restart animatrix-backend

If the site looks like plain HTML with unstyled buttons and form controls, check:

curl -I https://animatrix.desineuron.in/_next/static/css/<hash>.css

That request must return 200, not 404.

Auth Cookie Safety

The backend now treats forwarded HTTPS headers from nginx as authoritative for cookie security. Even so, keep:

BACKEND_BASE_URL=https://animatrix.desineuron.in

in the production backend environment so generated backend URLs and cookie policy stay aligned with the public host.

First Production Check

1. Open https://animatrix.desineuron.in/login
2. Register a user
3. Upload one image
4. Upload one video or one audio file depending on mode
5. Submit a job
6. Confirm job transitions out of created

Expected Non-Test Scope

This deployment verifies:

• app hosting
• TLS
• backend reachability
• auth flow
• asset upload
• job creation
• ComfyUI connectivity path

It does not assert final video quality or creative correctness.