secubox-openwrt/docs/wiki/Quick-Start.md
CyberMind-FR 01246a693d docs: Add comprehensive wiki and module documentation
Wiki structure:
- Home.md: Main navigation with module categories
- Installation.md: Getting started guide
- Quick-Start.md: First-time setup walkthrough
- Architecture.md: 4-layer architecture overview
- Modules.md: Complete catalog of 80+ modules

Module documentation (docs/wiki/modules/):
- Security.md: 15 security modules (CrowdSec, WAF, Guardians)
- Network.md: 12 network modules (HAProxy, Bandwidth, Traffic)
- Mesh.md: 7 VPN/mesh modules (WireGuard, P2P, MirrorNet)
- DNS.md: 6 DNS modules (DNS Master, Vortex, Meshname)
- Apps.md: 20 application modules (Jellyfin, Nextcloud, Matrix)
- System.md: 14 system modules (Config Vault, Reporter, RTTY)
- AI.md: 8 AI modules (Gateway, LocalAI, Threat Analyst)

Updated:
- SCREENSHOTS.md: Expanded to 111 modules with all categories
- README.md: Added wiki links and module index

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-26 12:35:31 +01:00

2.7 KiB

SecuBox Quick Start Guide

Get SecuBox up and running in 10 minutes.


Step 1: First Login

  1. Connect to your SecuBox router via Ethernet
  2. Open browser: https://192.168.1.1 (or 192.168.255.1)
  3. Login with: root / c3box

Login Screen


Step 2: Change Password

Navigate to System > Administration and change the root password.


Step 3: Network Setup

Configure WAN

Go to Network > Interfaces > WAN:

  • Protocol: DHCP Client (or PPPoE/Static)
  • Physical interface: eth1

Configure LAN

Go to Network > Interfaces > LAN:

  • IPv4 address: 192.168.255.1
  • Netmask: 255.255.255.0
  • DHCP: Enabled

Step 4: Enable Security

CrowdSec IDS/IPS

Navigate to SecuBox > Security > CrowdSec Dashboard:

  1. Enable CrowdSec
  2. Install default scenarios
  3. Configure bouncer

CrowdSec

WAF (Web Application Firewall)

Navigate to SecuBox > Security > WAF Filters:

  1. Enable mitmproxy WAF
  2. Configure filter rules
  3. Set default action: Block

Step 5: Mesh Network

Enable Mesh Daemon

Navigate to SecuBox > Mesh > Network:

  1. Enable mesh daemon
  2. Set node name
  3. Configure WireGuard peers

Mesh

Add Peers

Use the QR code scanner or manual configuration:

# Generate peer config
secuboxctl peer add mynode 10.10.10.2

Step 6: Service Exposure

Tor Hidden Services

Navigate to SecuBox > Privacy > Tor Shield:

  1. Enable Tor
  2. Add hidden service
  3. Note your .onion address

DNS/SSL Exposure

Navigate to SecuBox > Privacy > Exposure:

  1. Configure DNS provider (OVH, Gandi, Cloudflare)
  2. Add domain
  3. Request SSL certificate

Step 7: Install Apps

Navigate to SecuBox > Apps:

Browse and install from the catalog:

  • Jellyfin - Media server
  • Nextcloud - Cloud storage
  • Gitea - Git server
  • LocalAI - Local LLM

Common Tasks

View Metrics

SecuBox > Dashboard > Metrics

Metrics

Monitor Traffic

SecuBox > Monitoring > Bandwidth Manager

Check Security

SecuBox > Security > Security Threats

Manage VPN

SecuBox > VPN > WireGuard Dashboard


CLI Quick Reference

# System status
secubox status

# Mesh network
secuboxctl status
secuboxctl peers

# WireGuard
wgctl status
wgctl peers

# HAProxy
haproxyctl vhost list
haproxyctl status

# CrowdSec
cscli decisions list
cscli alerts list

Next Steps


SecuBox v1.0.0