Admin Frontend Setup
The Next.js admin dashboard (announcements, user/router management, live GPS map). It talks to the
Docker Setup (Full Stack)
Runs the whole SAPOT stack — server (db, redis, api, certgen, nginx), admin (admin dashboard), tileserver, and gsm-fastapi (SMS gateway) — via the root docker-compose.yml. Alternative to setting up each component individually by hand: server-setup.md (bare-metal server), admin-frontend setup, tileserver setup, gsm-module setup. All commands below run from the repo root, not server/.
GSM Module Setup
The SMS gateway (GSM-module/GSM-fastapi/) bridges the SAPOT server to a serial-attached GSM modem,
Mobile App Setup
This is the canonical setup guide. mobile-app/README.org and mobile-app/sapot-mobile-app/README.md point here for full instructions and cover only content not duplicated here (WSL/Android troubleshooting, command quick-reference).
Getting Started: Overview
SAPOT is built from independently-runnable components, each with its own toolchain and no shared build. Set up only the ones you need for the task at hand.
Quickstart: Run the Whole Stack Locally
The fastest path from a fresh clone to a working end-to-end setup (server + mobile app on a phone/emulator on the same LAN). For deeper detail on any single component, see the per-component setup guides linked at each step.
Server Setup (bare-metal)
Recommended: docker-setup.md — provisions MariaDB, Redis, and a TLS-terminating Nginx for you in one command, which this bare-metal path requires you to do by hand. Use this doc only if you specifically need to run the API outside Docker.