Chapter 2
System Requirements
2.1 Host Requirements
| Component | Minimum | Recommended |
|---|---|---|
| OS | Linux (kernel 4.x+), macOS 12+ | Ubuntu 22.04 LTS or RHEL 9 |
| CPU | 2 cores | 4 cores |
| RAM | 4 GB | 8 GB (16 GB for large networks) |
| Disk | 20 GB | 100 GB SSD (for raw cache + DB) |
| Python | 3.10 | 3.12 |
| Docker | 24.0 (if using containers) | 25.0+ |
2.2 Database Requirements
Neo4j (Default)
| Tier | Version | Edition | Notes |
|---|---|---|---|
| Development | 5.x | Community Edition | Free; single instance only |
| Production | 5.x | Community or Aura Free | Neo4j Aura provides managed cloud hosting |
| Enterprise | 5.x | Enterprise Edition | Required for clustering & advanced auth |
Neo4j must be reachable over the Bolt protocol (default port 7687). HTTP/HTTPS (7474) is optional and used only for the Neo4j Browser UI.
PostgreSQL (Pro/Enterprise Alternative)
PostgreSQL 14 or later. The psycopg v3 driver (psycopg[binary]) is required. Install the postgres extras: pip install "meshoptixiq-network-discovery[postgres]".
2.3 Network Requirements
| Direction | Port / Protocol | Purpose |
|---|---|---|
| MeshOptixIQ host → Network devices | TCP 22 (SSH) | Device collection via Netmiko |
| MeshOptixIQ host → Neo4j | TCP 7687 (Bolt) | Graph database reads/writes |
| MeshOptixIQ host → PostgreSQL | TCP 5432 | Alternate graph backend |
| MeshOptixIQ host → Internet | TCP 443 (HTTPS) | License validation (api.meshoptixiq.com) |
| Client browsers → MeshOptixIQ host | TCP 8000 | Query API & Web UI |
Firewall Note
Outbound HTTPS to api.meshoptixiq.com is required for initial license validation. If the host is air-gapped, the 72-hour grace period applies on first startup. Contact hello@meshoptixiq.com for extended offline licensing options.