v0.12.21478.5 MB
Apache-2.0
strict
core26
Caching proxy for craft builds, apt, snaps, Go modules, Docker and LXD
pkgproxy is a caching proxy for packages and images, built for
snapcraft, rockcraft and charmcraft builds. Set it up once and your
machines download each package, module or image from the internet only
once. After that it comes from the local cache, so your second build
skips the download. Handy too if you run CI, or create and throw away a
lot of containers and VMs.
What is cached:
- Debian and Ubuntu packages (apt)
- Snaps (snapd)
- Go modules
- LXD container and VM images, including the ones used by snapcraft,
rockcraft and charmcraft
- Docker Hub images
Packages, modules and images are checked against their published
checksums before they go into the cache. Package lists are refreshed
every few minutes. The cache is kept when the snap is updated, and
pkgproxy never deletes anything from it on its own; the documentation
(see below) says how to free disk space.
Getting started
The proxy starts after install and listens on port 3142 (3143 for LXD).
Then point each tool you use at it with the matching command. Run one
without the pipe first to see what it changes and why. If your shell
cannot find pkgproxyctl, use pkgproxy.pkgproxyctl.
On a desktop, pkgproxy in the applications menu, or pkgproxy.open,
opens its setup page in your browser.
setup lxd makes LXD containers use the proxy, and setup lxd-remote adds
cached LXD image remotes. The LXD commands need no root, only
membership in the lxd group. Each craft tool needs two: setup
lxd-remote for its build images, and setup snapcraft, setup rockcraft
or setup charmcraft for what its builds download. Add -undo to any
setup command to get the commands that revert it.
pkgproxyctl stats shows what is in the cache and how much downloading
it saved.
Working offline
What is in the cache keeps working without a network. pkgproxy goes
offline by itself while the machine has no network, airplane mode
included, and back online with it. To choose yourself:
Configuration
To use a different port:
Then run the setup commands again so your tools follow along.
The documentation of the newest version, the other options included,
is at https://zygoon.pl/pkgproxy/
For the version you have, which snap list pkgproxy shows, open the
same file at that version's tag: https://gitlab.com/zygoon/pkgproxy/-/tags
snapcraft, rockcraft and charmcraft builds. Set it up once and your
machines download each package, module or image from the internet only
once. After that it comes from the local cache, so your second build
skips the download. Handy too if you run CI, or create and throw away a
lot of containers and VMs.
What is cached:
- Debian and Ubuntu packages (apt)
- Snaps (snapd)
- Go modules
- LXD container and VM images, including the ones used by snapcraft,
rockcraft and charmcraft
- Docker Hub images
Packages, modules and images are checked against their published
checksums before they go into the cache. Package lists are refreshed
every few minutes. The cache is kept when the snap is updated, and
pkgproxy never deletes anything from it on its own; the documentation
(see below) says how to free disk space.
Getting started
The proxy starts after install and listens on port 3142 (3143 for LXD).
Then point each tool you use at it with the matching command. Run one
without the pipe first to see what it changes and why. If your shell
cannot find pkgproxyctl, use pkgproxy.pkgproxyctl.
pkgproxyctl setup apt | sudo sh
pkgproxyctl setup snap | sudo sh
pkgproxyctl setup go | sh
pkgproxyctl setup docker | sudo sh
pkgproxyctl setup lxd | sh
pkgproxyctl setup lxd-remote | sh
pkgproxyctl setup snapcraft | sh
pkgproxyctl setup rockcraft | sh
pkgproxyctl setup charmcraft | shOn a desktop, pkgproxy in the applications menu, or pkgproxy.open,
opens its setup page in your browser.
setup lxd makes LXD containers use the proxy, and setup lxd-remote adds
cached LXD image remotes. The LXD commands need no root, only
membership in the lxd group. Each craft tool needs two: setup
lxd-remote for its build images, and setup snapcraft, setup rockcraft
or setup charmcraft for what its builds download. Add -undo to any
setup command to get the commands that revert it.
pkgproxyctl stats shows what is in the cache and how much downloading
it saved.
Working offline
What is in the cache keeps working without a network. pkgproxy goes
offline by itself while the machine has no network, airplane mode
included, and back online with it. To choose yourself:
sudo snap set pkgproxy offline-mode=offline
sudo snap set pkgproxy offline-mode=neverConfiguration
To use a different port:
sudo snap set pkgproxy addr=:8080
sudo snap set pkgproxy lxd-tls-addr=:8443Then run the setup commands again so your tools follow along.
The documentation of the newest version, the other options included,
is at https://zygoon.pl/pkgproxy/
For the version you have, which snap list pkgproxy shows, open the
same file at that version's tag: https://gitlab.com/zygoon/pkgproxy/-/tags
Update History
v0.12.1 (127) → v0.12.2 (147)19 Nov 2026, 15:45 UTC
v0.12.0 (113) → v0.12.1 (127)13 Nov 2026, 03:15 UTC
v0.12.0 108 → 1139 Nov 2026, 00:30 UTC
v0.11.0 (79) → v0.12.0 (108)8 Nov 2026, 22:45 UTC
v0.10.0 (49) → v0.11.0 (79)7 Nov 2026, 00:45 UTC
v0.9.0 (34) → v0.10.0 (49)6 Nov 2026, 01:15 UTC
v0.8.0 (30) → v0.9.0 (34)26 Oct 2026, 17:30 UTC
v0.7.0 (28) → v0.8.0 (30)14 Oct 2026, 17:30 UTC
v0.6.1 (26) → v0.7.0 (28)14 Oct 2026, 06:00 UTC
v0.6.0 (24) → v0.6.1 (26)13 Sept 2026, 17:15 UTC
v0.5.1 (20) → v0.6.0 (24)2 Sept 2026, 07:00 UTC
v0.5.0 (18) → v0.5.1 (20)25 Aug 2026, 19:15 UTC
v0.2.1 (11) → v0.5.0 (18)25 Aug 2026, 11:30 UTC
v0.2.0 (9) → v0.2.1 (11)24 Aug 2026, 08:00 UTC
v0.1.0 (6) → v0.2.0 (9)20 Aug 2026, 07:00 UTC
0+git13.a6eb447 (4) → v0.1.0 (6)19 Aug 2026, 13:30 UTC
0+git13.a6eb447 3 → 419 Aug 2026, 12:15 UTC
0+git13.a6eb447 (3)19 Aug 2026, 09:15 UTC
19 Aug 2026, 08:45 UTC
19 Nov 2026, 15:17 UTC
19 Aug 2026, 09:15 UTC