NetAlertX/docs/INITIAL_SETUP.md

⚙ Initial Setup

📁 Configuration Files

• On first run, the app generates a default app.conf and app.db if unavailable.
• Preferred method: Use the Settings UI.
• If the UI is inaccessible, manually edit app.conf in /app/config/.

---

🖥️ Setting Up Scanners

• Define networks to scan by entering accessible subnets.
• Default plugin: ARPSCAN → Requires at least one valid subnet + interface in SCAN_SUBNETS.
• 📖 Subnet & VLAN setup guide (for troubleshooting and advanced scenarios).

🔄 PiHole Sync

• If using PiHole, devices can be synced automatically.
• 📖 PiHole configuration guide.

📦 Bulk Import

Note

You can bulk-import devices via the CSV import method.

---

🌍 Community Guides

• Various community-written configuration guides in Chinese, Korean, German, French.
• 📖 Community Guides

⚠️ Note: These guides may be outdated. Always refer to the official documentation first.

---

🛠️ Common Issues

Before creating a new issue:

• Check if a similar issue was already resolved.
• Review common debugging tips.
• Check Common Issues