secubox-deb/scripts
CyberMind-FR 29595a64d3 docs: Add TOOLS.md and missing README files
- docs/TOOLS.md: Complete reference of all build/generation tools
- scripts/README.md: Documentation for scripts directory
- remote-ui/README.md: Documentation for remote-ui module

Also fix build-storage-img.sh to use same slipstream logic as
build-ebin-live-usb.sh:
- Search packages in output/debs AND ~/.cache/secubox/debs
- Use dpkg -i --force-depends --force-overwrite (faster)
- Install all packages at once instead of per-package apt

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-26 20:38:29 +02:00
..
apply-crt-theme.py Apply CRT P31 Phosphor theme to all 38 module UIs 2026-03-23 18:56:11 +01:00
apply-light-theme.py Add CRT light theme across all UI modules 2026-03-25 08:55:45 +01:00
build-add-local.sh Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
build-all-local.sh feat(build): Slipstream ALL packages, AZERTY, no-compress option 2026-03-30 06:37:35 +02:00
build-all.sh fix(build): Add timeouts to prevent build script hangs 2026-04-26 19:04:20 +02:00
build-packages.sh fix(build): Add timeouts to prevent build script hangs 2026-04-26 19:04:20 +02:00
capture-module-screenshots.sh feat(kiosk): Add VirtualBox debug logging for X11 troubleshooting 2026-04-13 08:26:06 +02:00
create-secubox-vm.sh docs: Add VirtualBox quick start guide and VM creation script 2026-04-04 10:31:21 +02:00
deploy.sh Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
export-preseed.sh Add preseed system for configuration persistence 2026-03-24 19:41:08 +01:00
fix-emoji-fonts.sh feat(kiosk): Add VirtualBox debug logging for X11 troubleshooting 2026-04-13 08:26:06 +02:00
fix-namespace-errors.sh fix(kiosk): Skip X11 config on bare metal, disable service sandboxing 2026-04-15 09:52:20 +02:00
fix-navbar.sh Fix p2p/zkp/mesh navbar and add fix-navbar.sh script 2026-03-26 07:19:29 +01:00
generate-docs.py Add complete package READMEs and multilingual wiki documentation 2026-03-24 15:31:34 +01:00
install-apparmor.sh Add secubox-repo and secubox-hardening modules, CI/CD workflows 2026-03-22 22:15:01 +01:00
install-audit.sh Add secubox-repo and secubox-hardening modules, CI/CD workflows 2026-03-22 22:15:01 +01:00
local-repo-add.sh Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
new-module.sh feat: modular nginx config + hub roadmap + new modules 2026-03-21 20:34:01 +01:00
new-package.sh feat: modular nginx config + hub roadmap + new modules 2026-03-21 20:34:01 +01:00
port-frontend.sh Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
qemu-screenshot.sh feat(kiosk): Add VirtualBox debug logging for X11 troubleshooting 2026-04-13 08:26:06 +02:00
README.md docs: Add TOOLS.md and missing README files 2026-04-26 20:38:29 +02:00
requirements-screenshot.txt Add screenshot tool and wiki documentation 2026-03-24 12:36:19 +01:00
retrofit-nginx-modular.sh feat: modular nginx config + hub roadmap + new modules 2026-03-21 20:34:01 +01:00
rewrite-xhr.py Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
run-qemu.sh feat: Add QEMU/VBox launcher scripts + fix kiosk log bug 2026-04-10 12:02:25 +02:00
run-vbox.sh feat: Add QEMU/VBox launcher scripts + fix kiosk log bug 2026-04-10 12:02:25 +02:00
screenshot-tool.py Fix screenshot tool login with aiohttp 2026-03-24 13:24:30 +01:00
secubox-screenshots.sh feat(network): Smart auto-IP with ARP collision detection (v1.7.0.2) 2026-04-14 16:28:02 +02:00
setup-local-cache.sh Initial commit: SecuBox-DEB migration from OpenWrt to Debian 2026-03-21 09:41:06 +01:00
ui-fix-checker.sh fix(ui): Add sidebar navigation to 11 modules 2026-04-10 13:20:24 +02:00
ui-screenshot-capture.py fix(ui): Add sidebar navigation to 11 modules 2026-04-10 13:20:24 +02:00
update-css-design-tokens.py feat: Implement 6-Module Design System across all UI components 2026-04-08 18:29:36 +02:00
update-debian-nginx.sh feat: modular nginx config + hub roadmap + new modules 2026-03-21 20:34:01 +01:00
update-nginx-modular.sh feat: modular nginx config + hub roadmap + new modules 2026-03-21 20:34:01 +01:00

SecuBox-DEB — Scripts

Outils de build, déploiement et maintenance pour SecuBox-DEB.


Build Scripts

Script Description
build-packages.sh Build tous les packages .deb
build-all.sh Build complet + deploy
build-all-local.sh Build avec cache local
build-add-local.sh Ajouter package au repo local

Usage

# Build tous les packages
bash build-packages.sh

# Build un package spécifique
bash build-packages.sh --package secubox-hub

# Build avec cache local (plus rapide)
bash build-all-local.sh

Deploy Scripts

Script Description
deploy.sh Déployer sur cible via SSH

Usage

# Déployer un package
bash deploy.sh secubox-hub root@192.168.1.1

# Déployer tous les packages
bash deploy.sh all root@192.168.1.1

Package Scaffolding

Script Description
new-package.sh Créer structure package Debian
new-module.sh Créer module avec API FastAPI
port-frontend.sh Porter frontend depuis OpenWrt

Usage

# Nouveau package
bash new-package.sh secubox-mymodule

# Nouveau module avec API
bash new-module.sh mymodule

# Porter frontend LuCI
bash port-frontend.sh crowdsec-dashboard

Local Cache Setup

Script Description
setup-local-cache.sh Configurer apt-cacher-ng
local-repo-add.sh Ajouter .deb au repo local

Usage

# Setup initial
sudo bash setup-local-cache.sh

# Ajouter un package
bash local-repo-add.sh ../output/debs/secubox-core_1.0.0.deb

VM & Testing

Script Description
run-qemu.sh Lancer image dans QEMU
run-vbox.sh Lancer VM VirtualBox
create-secubox-vm.sh Créer VM SecuBox
qemu-screenshot.sh Screenshot VM QEMU

Usage

# Test dans QEMU
bash run-qemu.sh ../output/secubox-vm-x64.img

# Screenshot automatique
bash qemu-screenshot.sh

Fix & Maintenance

Script Description
fix-navbar.sh Corriger navbar modules
fix-emoji-fonts.sh Installer fonts emoji
fix-namespace-errors.sh Fix namespace Python
ui-fix-checker.sh Vérifier UI modules
update-nginx-modular.sh Update config nginx
retrofit-nginx-modular.sh Migrer config nginx
update-debian-nginx.sh Update nginx Debian

Security Scripts

Script Description
install-apparmor.sh Installer profils AppArmor
install-audit.sh Configurer auditd

Usage

sudo bash install-apparmor.sh
sudo bash install-audit.sh

Screenshot & Documentation

Script Description
capture-module-screenshots.sh Screenshots tous modules
secubox-screenshots.sh Screenshots automatiques

Export Scripts

Script Description
export-preseed.sh Exporter config preseed

Environment Variables

Variable Description
SECUBOX_TARGET Cible SSH (user@host)
SECUBOX_PORT Port SSH (défaut: 22)

See Also


Author

Gerald KERMA devel@cybermind.fr