Repository navigation
Trixie
🟢 ROOT — Debian system
What it is for. Know what the Debian 13 (Trixie) base changes for SecuBox, what the current release ships, how to upgrade a Debian 12 box in place, and which traps were met.
Debian 13 (Trixie) is the base of SecuBox from alpha 9. Packages are built as ~trixie1 and published in the trixie suite of apt.secubox.in, for arm64 and amd64. The bookworm suite no longer evolves.
The v3.0.0-alpha.12 line (October 2026, pre-release) is entirely Trixie:
| Target | Image |
|---|---|
| x86-64 live USB (UEFI and BIOS) | secubox-live-amd64-trixie.img.gz |
| x86-64 headless installer (erases the first disk) |
secubox-installer-amd64-trixie.iso.gz / .img.gz
|
| VM x64 (VirtualBox, QEMU) |
secubox-full-vm-x64-trixie.img.gz, secubox-isp-vm-x64-trixie.img.gz
|
| Raspberry Pi 4 / 400 |
secubox-full-rpi-arm64-trixie.img.gz, secubox-isp-rpi-arm64-trixie.img.gz
|
| MOCHAbin |
secubox-lite-mochabin-trixie.img.gz, secubox-isp-mochabin-trixie.img.gz
|
| ESPRESSObin v7 | secubox-lite-espressobin-v7-trixie.img.xz |
How to use them: Installation, Live-USB.
| bookworm (12) | trixie (13) | |
|---|---|---|
| Kernel | 6.6 LTS | 6.12 |
| Python | 3.11 | 3.13 |
| nginx | 1.22 | 1.26 |
| HAProxy | 2.6 | 3.0 |
| Unbound | 1.17 | 1.26 |
| LXC | 5.0 | 6.0 |
A Debian 12 box was upgraded to Debian 13 and validated on an amd64 PC and on a MOCHAbin (about 10 and 45 minutes, no SecuBox package removed). Steps:
- Save the reference state (active services, listening ports, containers,
/etc/apt). - Point the apt sources to
trixie,trixie-updatesandtrixie-security. - Block unwanted packages with an apt preference:
exim4*(mail lives in a container) and, on the MOCHAbin, the Debian kernels. - Simulate (
apt-get -s full-upgrade), thenapt upgrade --without-new-pkgsandapt full-upgrade, in a detached systemd unit, with the apt cache on a data volume if the root is small. - Install
python3-python-multipart, recreate the remaining Python virtual environments, reboot, then compare with the reference state.
| Symptom | Cause | Remedy |
|---|---|---|
| Several modules in a restart loop |
python-multipart installed by pip for Python 3.11 |
python3-python-multipart (not python3-multipart, a different library) |
| A virtual-environment module no longer starts | Venv built for Python 3.11 | Recreate the venv (the billets package now does it by itself) |
nftables fails, and the mesh too |
Interfaces become end0 and end1
|
net.ifnames=0 on the kernel command line |
| 421 on every public site in a browser | HAProxy 3.0 negotiates HTTP/2; the URI rewrite used %[url]
|
%[pathq] (fixed in secubox-haproxy 1.8.26) |
systemctl is-active fails during the upgrade |
systemd upgrades itself |
Follow an end message in the journal, not the unit state |
The surfer answers 502 on a .onion
|
It forced https | http for .onion (fixed in secubox-surf 1.0.30) |
| LAN DNS stays down ~4 min after a reboot | Unbound loads hundreds of thousands of zones and exceeded the 90 s start timeout | 600 s start timeout (secubox-dns-lan 0.1.1) |
| A module fails at first start then recovers alone | The socket chmod waited 15 s; under boot load that was too short |
Wait 120 s; uvicorn forces the socket to 666, the chmod 660 stays essential |
| A container stays stopped after a reboot |
lxc.service is masked on some machines (autostart inoperative) |
VoiceStudio starts its container itself in permanent mode (0.5.4) |
| The radio rejects every track (403) | A cookies file refused by YouTube |
ytsas retries without cookies for public videos (0.2.13) |
The MOCHAbin now boots on the standard Debian 6.12 kernel, with a SecuBox configuration fragment (board/mochabin/kernel/config-6.12-stock-wan.fragment) that builds into the kernel what the WAN port (eth2) needs: I2C controller, SFP cages, PHYLINK, MVPP2, Marvell PHY, and the DSA switch with its bridge. The board boots through extlinux, not boot.scr, and the previous SecuBox-built kernel is no longer kept.
Why the DSA switch must be built in: loaded as a module, it arrived after the network opened eth2; the network driver then switched its buffers again, reopened all ports, and the eth2 PHY never came back up (no link). Built in, it is ready before services start and the link comes up in seconds. NET_DSA also depends on HSR: an HSR left as a module capped it at module, so it is built in too.
Replacing a kernel of the same version: /boot is vfat and dpkg makes no backup link there. Remove System.map-<version> and config-<version> first, then install, then regenerate the initrd.
Application containers stay on bookworm and move to Trixie one by one. Tracking: #1294 and #1997.
- Installation - choose an installation path
- Live-USB - the Trixie live stick
- ARM-Installation - ARM boards and U-Boot
- Profils - lite, isp, full
- Troubleshooting
SecuBox-Deb · Licence : CMSD-1.0 (Source-Disclosed)
Contact : CyberMind · Gérald Kerma · Notre-Dame-du-Cruet, Savoie
Hardware-Matrix · Acknowledgments · Wiki v2.5.0
SecuBox | FR | DE | 中文 | v3.0.0-alpha.12
- Home
- Architecture
- Trixie | FR
- Hardware-Matrix
- Roadmap
- Profils
- Modules-by-Profile 📦 lite / isp / full : ce qu'embarque chaque profil | FR
- Modules-by-Family 🗂️ les modules par famille | FR
- DNS-Filtrage
- Multiboot ⭐
-
Live-USB-VirtualBox
run-vbox.sh -
Live-USB-QEMU
run-qemu.sh - Live-USB | FR | DE | 中文
- Auto-Load 🚚 boxes sans écran | FR
- First-Boot-Premier-Pas 🧭 premier pas | FR
- Installation | FR | DE | 中文
- ARM-Installation | FR | DE | 中文
- Netboot-Install 🔧 MOCHAbin netboot + signed install
- ESPRESSObin | FR | DE | 中文
- Eye-Remote 📡
- Android-ToolBox 📱 one-tap R3
- Browser-Extension 🧩 cartographie
- QEMU-ARM64 🖥️
- Configuration | FR | DE | 中文
- Troubleshooting | FR | DE | 中文
- ToolBox 👁️ cabine numérique · rapport vie privée
- Anti-Track 🛡️ bloque · empoisonne · anonymise
- Billets 📮 micro-blog gateway · média vignette zoomable
- Messagerie 💬 mur public, messages privés, radio/Billets/BBS centralisés
- Identite-SBX-OS 🪪 personnes, appareils, comptes liés, connexion passive
- Metalogue 🕸️ OSINT suite · Maigret + SpiderFoot (Maltego-style)
- WAF 🛡️ pare-feu applicatif autonome (nft direct, hors-HTTP) | FR
- SOC 🎯 vues rassemblées | FR
- Actor-Intelligence 🕵️ acteurs, échelle de réponse | FR
- NAC 🔐 contrôle d'accès réseau | FR
- Webfilter 🧹 filtrage DNS par catégories et par appareil | FR
- Interceptor 🎯 supervision de l'inspection (sbxmitm, sbxwaf, nDPI) | FR
- Network-Modes 🌐 modes réseau, WAN, interfaces | FR
- Caches-and-Mirrors 💾 caches de la box et dépôt APT local | FR
- Portal 🚪 portail de session | FR
- Certificates 📜 certificats | FR
- Metrics 📊 mesures, sites, cartes, rapport PDF | FR
- SBX-OS 🧩 le Hall en application | FR
- Aurora-Design 🎨 design system admin | FR
- Admin-Panels-Gallery 🖼️ galerie des 37 pages | FR
- ThreatMesh 🛰️ blocklist souveraine (feeds + mesh, sans CAPI) | FR
- Modules 🇬🇧
- MODULES-FR 🇫🇷
- MODULES-DE 🇩🇪
- MODULES-ZH 🇨🇳
-
Operations-Runbook 🛠️ incidents | FR
-
API-Reference | FR | DE | 中文
- Multi-Agent-Worktree — un agent · une issue · une branche