anar/anarbib-debian-iso
Watch
0
0
Fork
You've already forked anarbib-debian-iso
 0
mirror of https://codeberg.org/ASR2026/anarbib-debian-iso.git synced 2026-10-17 19:51:56 +02:00
Code Issues Projects Releases Packages Wiki Activity
Image Debian 13 minimale pour déployer AnarBib sur une VM, un VPS ou un serveur bare metal.
65 commits 2 branches 29 tags 358 KiB
  • Python 50.3%
  • Shell 49.5%
  • Makefile 0.2%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
ASR2026 a90f5a1c86 Merge pull request 'fix(update): actualiser les images des conteneurs' (#8) from fix/actualisation-images-conteneurs into main 
Reviewed-on: https://codeberg.org/ASR2026/anarbib-debian-iso/pulls/8
2026-10-16 12:41:52 +02:00
.forgejo/workflows fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
config fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
scripts fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
.gitignore feat: add Debian 13 AnarBib image bootstrap 2026-10-11 14:25:44 +02:00
LICENSE docs: declarer la licence libre du projet 2026-10-11 14:39:10 +02:00
Makefile feat: add Debian 13 AnarBib image bootstrap 2026-10-11 14:25:44 +02:00
README.en.md fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
README.es.md fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
README.fr.md fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00
README.md fix(update): actualiser les images des conteneurs 2026-10-16 12:40:53 +02:00

README.en.md

AnarBib Debian 13

Esperanto • Français • English • Español

Minimal Debian 13 image to deploy AnarBib on a VM, VPS, or bare-metal server.

The image boots without a desktop environment and automatically launches a persistent terminal setup assistant on the main console. The assistant installs the operating system on the primary drive upon confirmation, sets up the local user account, configures the hostname and timezone, and reboots into the installed system.

Architecture

  • Debian 13 "trixie" (amd64 architecture)
  • Headless system optimized for self-hosted instances
  • SSH, Docker, Compose, and Ansible Core pre-installed
  • Persistent terminal installation assistant launched automatically from ISO
  • Persistent disk installation with EFI, ext4, and GRUB support
  • AnarBib deployment started automatically on first boot
  • Custom TTY1 local console and SSH banners (network access, SSH, admin username and password)
  • Automatic nightly Debian and AnarBib updates (anarbib-update.timer)
  • Embedded AnarBib source tree in /opt/anarbib
  • Reference installer: /opt/anarbib/install.sh

Automatic and Manual Updates

The installed system includes an automated and secure update mechanism:

  • Automatic Nightly Updates: The anarbib-update.timer unit triggers /usr/local/sbin/anarbib-auto-update every night at 06:30. It applies Debian security patches, pulls the configured Docker images, recreates only affected containers while preserving their volumes, then synchronizes AnarBib (pending SQL migrations, edge functions, resources, and front build).
  • Manual Single-Command Update: 
    sudo anarbib-auto-update
  • Update Logs: 
    tail -f /var/log/anarbib-update.log
  • Update Channel (Stable Releases vs Development Branch): By default, the system follows the main development branch. To lock the machine onto official release tags (v*) in production: 
    echo "tag" | sudo tee /var/lib/anarbib/track_channel
    To switch back to following the main branch: 
    echo "branch" | sudo tee /var/lib/anarbib/track_channel
  • Disabling the Automatic Timer (if manual control is preferred): 
    sudo systemctl disable --now anarbib-update.timer

Building the ISO

The build machine requires live-build, xorriso, and Debian build packages for amd64:

./scripts/build-iso.sh

The ISO file is generated in the repository root.