Operations
Deployment, configuration, and maintenance guide for the IonGuard platform in production environments.
Overview
IonGuard is distributed as a set of Docker containers managed via Docker Compose. The infrastructure includes:
| Service | Description |
|---|---|
| Nginx | Reverse proxy with HTTPS |
| PHP-FPM | Laravel application |
| MariaDB | Relational database |
| Valkey (Redis) | Cache, queues, and sessions |
| InfluxDB | Time-series storage for BLE signals |
| Mosquitto | MQTT broker for hardware communication |
| Reverb | WebSocket server for real-time |
| Workers | Queue processors and MQTT listeners (1 per enabled module) |
Deployment models
On-premises
Local installation on the customer's infrastructure. The package includes all containers and the documentation is accessible offline at /docs.
Minimum requirements:
- Ubuntu 24.04 LTS or Debian 12+
- Docker Engine 24+ and Docker Compose v2
- 4 GB RAM (8 GB recommended)
- 20 GB disk
- Local network with access to BLE gateways
Cloud (SaaS)
Deploy on cloud infrastructure with access via subdomain per tenant.
Guides
Deployment
- Requirements — Hardware and software requirements
- Installation — Step-by-step installation
- Configuration — Environment variables and settings
- Module Installation — Install and remove modules
Maintenance
- Backup and Restore — Backup strategy
- Update — Version upgrade process
- Monitoring — Health check, logs, and metrics
- Troubleshooting — Diagnosing common issues