- Shell 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| dists/stable | ||
| docs | ||
| packaging/butterrepo-keyring | ||
| pool/main | ||
| key.asc | ||
| LICENSE | ||
| migrate.sh | ||
| README.md | ||
| setup-gpg.sh | ||
| update-repo.sh | ||
ButterRepo
Community APT repository for Debian users who want the latest stable releases.
ButterRepo has moved home. The canonical repository now lives on Butterforge, our self-hosted forge. The old Codeberg address keeps working — it is now an automatically-synced mirror and will stay up for the foreseeable future. Nothing breaks if you do nothing. If you set ButterRepo up before the move, see Migrating from the Codeberg address.
Available Packages
| Package | Version | Description |
|---|---|---|
butterrepo-keyring |
1.0.0 | butterrepo-keyring |
fzf |
0.74.3 | fzf |
geany-latest |
2.1 | Geany IDE with plugins |
ghostty |
1.3.1 | ghostty |
helium-browser |
0.15.5.1 | Lightweight Chromium-based browser |
ly |
1.4.1 | ly |
neovim |
0.12.4 | Neovim (latest stable, built from source) |
oxwm |
0.12.0 | Dynamic X11 window manager with Lua scripting |
picom |
13 | picom |
quickshell |
0.3.0 | quickshell |
rofi |
2.0.0 | rofi |
zen-browser |
1.21.14b | Privacy-focused Firefox fork |
Installation
1. Add the repository
# Add repository GPG key
curl -fsSL https://apt.justaguy.dev/key.asc | sudo gpg --dearmor -o /usr/share/keyrings/butterrepo.gpg
# Add repository to sources
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/butterrepo.gpg] https://apt.justaguy.dev stable main" | sudo tee /etc/apt/sources.list.d/butterrepo.list
# Update package list
sudo apt update
2. Install packages
# Install what you need
sudo apt install fzf
sudo apt install geany-latest
sudo apt install ghostty
sudo apt install helium-browser
sudo apt install ly
sudo apt install neovim
sudo apt install picom
sudo apt install quickshell
sudo apt install rofi
sudo apt install zen-browser
3. Updates
Packages update with your system:
sudo apt update && sudo apt upgrade
Migrating from the Codeberg address
If your sources file points at justaguylinux.codeberg.page, that address still works
and continues to receive every update — the mirror syncs automatically on every push.
When you're ready to switch to the canonical address (same packages, same signing key,
only the URL changes):
sudo sed -i 's|https://justaguylinux.codeberg.page/butterrepo|https://apt.justaguy.dev|' /etc/apt/sources.list.d/butterrepo.list
sudo apt update
Your existing keyring keeps working — the repository is signed with the same key at both addresses.
Prefer a script you can read first? migrate.sh in this repository does
exactly the above (with a backup of your sources file) and nothing else.
Migrating from Old Repos
If you previously used helium-deb-repo or zen-deb-repo, clean up the old sources:
sudo rm -f /etc/apt/sources.list.d/helium-deb-repo.list /etc/apt/sources.list.d/zen-deb-repo.list
sudo rm -f /usr/share/keyrings/helium-deb-repo.gpg /usr/share/keyrings/zen-deb-repo.gpg
Supported Distributions
Packages are built and tested on Debian 13 (Trixie). Other Debian-based distributions are not tested — a package will install only if your system satisfies its dependencies, and apt will tell you if it doesn't.
Uninstallation
# Remove packages
sudo apt remove fzf geany-latest ghostty helium-browser ly neovim picom quickshell rofi zen-browser
# Remove repository
sudo rm /etc/apt/sources.list.d/butterrepo.list
sudo rm /usr/share/keyrings/butterrepo.gpg
sudo apt update
About
This is an unofficial community repository providing latest stable releases as Debian packages.
- fzf: https://github.com/junegunn/fzf
- Geany: https://www.geany.org
- Ghostty: https://ghostty.org
- Helium Browser: https://helium.computer
- ly: https://github.com/fairyglade/ly
- Neovim: https://neovim.io
- oxwm: https://github.com/tonybanters/oxwm
- picom: https://github.com/yshui/picom
- quickshell: https://quickshell.org
- rofi: https://github.com/davatorium/rofi
- Zen Browser: https://zen-browser.app
Privacy
ButterRepo is built to respect your privacy:
- No tracking, no analytics, no accounts. Just signed static files served over HTTPS.
- No access logs, by policy. The repository is now served from our own
infrastructure (Butterforge). That's a real change from Codeberg Pages, where the
platform simply never showed maintainers any logs — here, the server is ours, so
"no logs" is a choice we make and keep. The web server (Caddy) writes no access
logs for
apt.justaguy.dev; the exact server configuration is published in this repository atdocs/apt-vhost.Caddyfileso you can see precisely what runs. There is still no way for me to see who installed what, when, or from where — and that remains intentional. - No CDN or third-party proxy sitting between you and the files.
- The forge's web pages (justaguy.dev) use self-hosted, cookieless Umami for aggregate page counts — no cookies, no third parties, nothing identifying. It never runs on the apt endpoints: those remain script-free static files, exactly as above.
- GPG-signed packages so you can verify what you receive, without needing to trust the transport.
- The Codeberg mirror is governed by Codeberg's Privacy Policy, as before.
This means I will never be able to tell you how many people use ButterRepo — and that's a tradeoff I'm happy with. If popularity metrics ever start to matter more than privacy, that will be a community conversation, not a quiet change. Moving to self-hosting doesn't change that commitment; it just means you're trusting my configuration instead of Codeberg's platform, which is why the configuration is public.
License
GPL-2.0 - See LICENSE for details.
Support
Connect
- YouTube — tutorials and guides
- Butterforge — source code and projects
- The Butter Lab — Discourse forum
- The Churn — community chat (Fluxer)
- Wiki — documentation and guides
- Mastodon — @justaguylinux@fosstodon.org
- Butterbian — a Debian-based distro
Made with butter by JustAGuyLinux
