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

3.2 KiB

Raw Blame History

SecuBox Installation Guide

This guide covers installing SecuBox on OpenWrt 24.10.

Requirements

Hardware

Requirement	Minimum	Recommended
CPU	ARMv8 / x86_64	Cortex-A72 or better
RAM	512 MB	2 GB+
Storage	256 MB	1 GB+
Network	1 Ethernet	2+ Ethernet / WiFi

Supported Devices

MochaBin (ARM64) - Primary reference platform
x86_64 VM - VMware, VirtualBox, Proxmox, QEMU
Raspberry Pi 4 - With USB Ethernet adapter
Generic x86 - Any x86_64 with OpenWrt support

Installation Methods

Method 1: Pre-built Image (Recommended)

Download the pre-built SecuBox firmware image:

# For MochaBin ARM64
wget https://github.com/gkerma/secubox-openwrt/releases/latest/download/secubox-mochabin.img.gz
gunzip secubox-mochabin.img.gz
dd if=secubox-mochabin.img of=/dev/sdX bs=4M status=progress

# For x86_64 VM
wget https://github.com/gkerma/secubox-openwrt/releases/latest/download/secubox-x86-64.vmdk

Method 2: Package Installation

Install SecuBox packages on existing OpenWrt:

# Add SecuBox feed
echo "src/gz secubox https://packages.secubox.in/releases/24.10" >> /etc/opkg/customfeeds.conf

# Update and install
opkg update
opkg install secubox-core secubox-mesh luci-theme-secubox

# Install all LuCI modules
opkg install luci-app-secubox-admin luci-app-crowdsec-dashboard \
    luci-app-wireguard-dashboard luci-app-haproxy

Method 3: Build from Source

Build SecuBox using the OpenWrt SDK:

# Clone repository
git clone https://github.com/gkerma/secubox-openwrt.git
cd secubox-openwrt

# Sync local feed
for pkg in package/secubox/*/; do
  name=$(basename "$pkg")
  rsync -av --delete "$pkg" "secubox-tools/local-feed/$name/"
done

# Build packages
./secubox-tools/local-build.sh build luci-app-secubox
./secubox-tools/local-build.sh build secubox-core

Post-Installation

1. Access LuCI

Open your browser and navigate to:

https://192.168.1.1

Default credentials:

Username: root
Password: c3box

2. Initial Configuration

Change the root password
Configure network interfaces
Set timezone and hostname
Enable SecuBox theme

3. Enable Services

# Start mesh daemon
/etc/init.d/secuboxd enable
/etc/init.d/secuboxd start

# Start CrowdSec
/etc/init.d/crowdsec enable
/etc/init.d/crowdsec start

Upgrading

Via sysupgrade

# Download latest firmware
wget https://github.com/gkerma/secubox-openwrt/releases/latest/download/secubox-sysupgrade.bin

# Upgrade (keep settings)
sysupgrade -v secubox-sysupgrade.bin

Via opkg

opkg update
opkg upgrade secubox-core secubox-mesh luci-theme-secubox

Troubleshooting

Package conflicts

# Force reinstall
opkg install --force-reinstall secubox-core

LuCI not loading

# Clear LuCI cache
rm -rf /tmp/luci-*
/etc/init.d/uhttpd restart

Theme not applying

# Set theme via UCI
uci set luci.main.mediaurlbase=/luci-static/secubox
uci commit luci

3.2 KiB Raw Blame History