Applications Overview¶

This section documents all applications running in the homelab infrastructure.

Deployed Applications¶

Production (Kubernetes)¶

Application	Purpose	Dashboard	Status
Home Portal	Unified homelab dashboard	http://home.internal	✅ Running
Money Tracker	Personal finance management	http://money.internal	✅ Running
Trip Planner	AI-powered travel planning	http://travel.internal	✅ Running

Development (Host-Based)¶

All development now runs directly on the Proxmox host using Node.js 22 in tmux sessions.

Application	Purpose	Dev URL	Host Path
Home Portal	Unified homelab dashboard	http://localhost:3000	`/root/projects/home-portal`
Money Tracker	Personal finance management	http://localhost:3000	`/root/projects/money-tracker`
Trip Planner	AI-powered travel planning	http://localhost:3000	`/root/projects/trip-planner`

Planned¶

Application	Purpose	Status
RMS	Recipe Management System	Planning - Next.js rewrite

Infrastructure Services¶

Supabase (Kubernetes)¶

API Gateway (Kong): http://10.89.97.214:8000
Studio Dashboard: http://10.89.97.215:3000
Architecture: Multi-App Schema Isolation

Media Services¶

Plex Media Server (LXC 111)¶

Access via SSH: ssh root@10.89.97.10

Plex Web: http://10.89.97.10:32400/web
Documentation: plex.md

arr-stack (VM 100)¶

Access via SSH: ssh root@10.89.97.50

Documentation¶

Infrastructure Docs: https://otterwiki.bogocat.com (OtterWiki)

Tech Stack¶

All new applications follow this standard stack:

Framework: Next.js 16 (App Router)
UI Library: React 19
Styling: Tailwind CSS v4
Database: Supabase (PostgreSQL + Auth + Storage)
Deployment:
Development: Host-based with tmux-managed dev servers (/root/projects/)
Production: Kubernetes with k3s

Quick Access¶

For Developers¶

# Start home-portal dev server
cd /root/projects/home-portal
npm run dev
# Or attach to existing tmux session
tmux attach -t home-portal

# Start money-tracker dev server
cd /root/projects/money-tracker
npm run dev
# Or attach to existing tmux session
tmux attach -t money-tracker

# Start trip-planner dev server
cd /root/projects/trip-planner
npm run dev
# Or attach to existing tmux session
tmux attach -t trip-planner

For End Users¶

All production apps use hostname-based routing via NGINX Ingress (10.89.97.220):

Home Portal: http://home.internal - Unified dashboard for all homelab services
Money Tracker: http://money.internal - Personal finance management
Trip Planner: http://travel.internal - AI-powered travel planning

Adding New Applications¶

See the Creating New App Guide for the complete 5-stage workflow.

Quick Checklist¶

✅ Create project: npx create-next-app@latest /root/projects/<name>
✅ Apply skeleton: /root/tower-fleet/scripts/scaffold-nextjs.sh /root/projects/<name> <name>
✅ Create PostgreSQL schema in Supabase
✅ Configure .env.local with supabase-sandbox credentials
✅ Document in this section
✅ Deploy to Kubernetes with /root/tower-fleet/scripts/deploy-<app>.sh