Admin Frontend Deployment
The SAPOT admin panel (admin-frontend/sapot-admin/) is a Next.js 16 application providing user management, ban management, announcements, activity logs, and router telemetry dashboards.
Offline Docker Deployment Bundle
This is SAPOT's production Docker path for a LAN-only site. It is separate from
Environment Configuration
All SAPOT components are configured via environment variables. This document lists every variable, its component, default, and whether it is required in production.
GSM Module Deployment
The GSM module (GSM-module/GSM-fastapi/) is a FastAPI application that bridges an Arduino-connected SIM800L/SIM900 GSM modem to the SAPOT server's SMS webhook. It exposes send, message-history, and health endpoints, then forwards serially received SMS to the main server.
Incident Response
Process for handling a live production problem — who does what, in what order, and how it gets closed out. For the technical steps once you know what's wrong (restore a backup, rotate a cert, roll back a deploy), see runbooks.md; this doc is about triage and communication around those steps.
Installing SAPOT on Ubuntu Server 24.04 (Docker bundle)
Step-by-step walkthrough for standing up a new SAPOT site on a fresh Ubuntu
Maintenance
Routine, scheduled upkeep for a running SAPOT deployment, as opposed to runbooks.md (respond to a specific event) and incident-response.md (process during an active problem). Database backup is automated (see runbooks.md); everything else here is a manual checklist for whoever operates the deployment.
Mobile App — EAS Build & Deployment
The SAPOT mobile app (mobile-app/sapot-mobile-app/) is an Expo managed-workflow React Native app built with EAS Build (Android only).
Monitoring and Logging
---
Deployment Overview
SAPOT is a multi-component system deployed as independent services on a LAN.
Operational Runbooks
Step-by-step procedures for operating SAPOT in production. Each runbook includes a verification step — do not consider a procedure complete until verification passes.
Secrets Management
Current state
Server Deployment
The SAPOT server is a FastAPI application run by Gunicorn behind an Nginx reverse proxy.
Tileserver Deployment
The SAPOT tileserver serves offline map tiles to the mobile app. It runs maptiler/tileserver-gl in Docker, serving a regional OSM MBTiles crop (currently Batangas).