Repository navigation
burrow v1.1.1
A bug-fix release from a second, independent review of the whole code base. Upgrade by
re-running the installer (or burrow deploy). Your secret and links are kept.
Fixed
- Changing the decoy site made every page unreadable (HTTP 403). Files synced into
a running site lost their read permission for the unprivileged web server. That happened
after editingsite.local/, changing the domain, or on January 1st (the year in the
footer). Sites now stay readable, never go empty during a sync, and a symlinked site
directory is refused. burrow <command> --helpran the command for most commands:uninstall --help
uninstalled, androtate --helpreplaced the secret.--helpnow only prints usage,
and every command rejects arguments it doesn't know.rotatewithout a terminal
requires--yes.- Installer:
BURROW_DRY_RUNandBURROW_SKIP_HOST_SETUPfailed open on values liketrue.
They now accept 1/true/yes and 0/false/no, and reject anything else.- Upgrades remove files that a release dropped.
- Upgrades install code with 0755/0644 modes, never group-writable.
- Re-runs take firewall ports from the existing configuration, and report requested
settings that differ instead of silently ignoring them. - Dry runs preview the real host plan and say "Dry run complete".
burrow smoke --linkaccepts links whose secret is in base64 form (asmtg access
prints them), not only theee…hex form. Links are checked before Docker is needed.- Probe client:
- A blackholed address (for example a firewalled IPv6 address listed first) can no
longer use up the whole connect budget; addresses now share it. - The TLS handshake in the HTTPS probe respects the time budget.
--timeoutand--retry-delayare range-checked.
- A blackholed address (for example a firewalled IPv6 address listed first) can no
statusbefore the firstupsays so instead of failing with a generic error.config setnever leaves a copy of the secret behind when it fails.- The watchdog restarts mtg only when the probe reports it unhealthy, never because the
probe tool itself failed. - Link fields in error messages are escaped, so a crafted link cannot write control
sequences to the terminal. install-host.shalso finds SSH ports held by a socket-activatedssh.socket.- Validation rejects IPv6 together with a specific
BIND_ADDR(which would have listened
on loopback only) and paths containing backslashes. Simple-mode configs whose subnet
changed keep loading. - The decoy's Content-Security-Policy allows self-hosted fonts.
- Docs:
- The upstream SOCKS example pointed at
127.0.0.1, which is mtg's own container; it
now uses the Docker bridge gateway. - Upgrade instructions no longer suggest
git pullfor installs without a git
checkout. - The deployment guide states where server commands run.
- The generated
.envlinks to the right README section.
- The upstream SOCKS example pointed at
- Tests: stronger assertions, test servers that stop cleanly, and a realistic upgrade test
(a page dropped between releases must disappear).
Changed
- busybox 1.38.0 (pinned by digest) for the one-shot
decoy-inithelper (Dependabot #1). - The website works on phones: commands wrap instead of overflowing.