FAQ
Frequently asked questions about m1nd.
General
What does m1nd stand for?
m1nd is a stylised name — the "1" replaces the "i", reflecting the platform's focus on network intelligence and visibility.
Is m1nd production-ready?
m1nd is currently in alpha (v3.13.x). Features are complete and working, but expect rough edges. Test thoroughly before deploying in production environments.
What license is m1nd under?
MIT License — free to use, modify, and distribute. No sensor limits, no feature gates, no telemetry.
Does m1nd phone home?
No. m1nd makes zero outbound connections except to your configured targets, SMTP servers, and webhook URLs. No analytics, no telemetry, no cloud dependencies.
Installation
What are the minimum system requirements?
- Any Linux host (Debian 11+, Ubuntu 20.04+, Raspberry Pi OS)
- Python 3.9+
- ~200MB disk space for the application
- ~50MB RAM baseline (scales with number of monitored targets)
Can I run m1nd on a Raspberry Pi?
Yes. m1nd runs comfortably on a Raspberry Pi 3B+ or newer. It's designed to be lightweight — single Python process with SQLite storage.
Can I run m1nd in Docker?
Not officially supported yet. The install script creates a systemd service, which is the recommended deployment method. Docker support is on the roadmap.
How do I update m1nd?
Use the Settings > Update page in the dashboard. It pulls the latest code from GitHub, creates a backup, and restarts the service. No SSH required.
Monitoring
How many targets can m1nd monitor?
There's no hard limit. In practice, a single m1nd instance comfortably monitors 50-100 targets with synthetic testing and 100+ uptime monitors. Performance depends on test intervals and target response times.
Does m1nd support SNMPv3?
Yes. Full SNMPv3 support with auth and privacy protocols. Configure credentials in the V1sion config modal or Brain credential vault.
Can I monitor targets behind a VPN?
Yes — that's exactly what the OOB Access feature is for. Connect m1nd to a ZeroTier or Tailscale network, and it can monitor targets on that network.
How long is data retained?
Indefinitely by default. All test results and alert history are stored in SQLite. You can run database cleanup from Settings > System > DB Cleanup to prune old data.
Security
How are credentials stored?
Secrets (SNMP community strings, SSH passwords, API keys) are encrypted with AES-256-GCM in a vault. The vault must be unlocked with a password before credentials can be accessed.
Is the API authenticated?
Yes. All API endpoints require either a session cookie (browser) or a scoped API key (header). API keys can be restricted to specific scopes (e.g., monitors:read only).
Does m1nd support 2FA?
Yes. TOTP two-factor authentication can be enabled per user in Settings > Security.
Architecture
Why SQLite instead of PostgreSQL?
SQLite with WAL mode provides excellent read/write performance for m1nd's workload, with zero infrastructure overhead. No separate database server to configure, backup, or maintain. The entire database is a single file that can be copied or backed up trivially.
Why not a SPA framework for the whole frontend?
The frontend uses a hybrid "island" architecture — Vue 3 for interactive components, vanilla JS + D3 for performance-critical topology rendering. This is intentional: D3 force simulations update at ~60fps, and wrapping that in Vue's reactivity system would add significant overhead.
Can multiple users use m1nd simultaneously?
Yes. m1nd supports multi-user access with 5 role levels. Each user sees their own identity in the topbar and has permissions appropriate to their role.