3.3 KiB
3.3 KiB
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
- Raspberry Pi 400 - Keyboard computer (same SoC as Pi 4)
- Raspberry Pi 5 - Latest generation
- 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
See also:
SecuBox v1.0.0