Versionv0.12.2
Revision147
Size8.5 MB
LicenseApache-2.0
Confinementstrict
Basecore26

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.

 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 | sh


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:

 sudo snap set pkgproxy offline-mode=offline
 sudo snap set pkgproxy offline-mode=never


Configuration

To use a different port:

 sudo snap set pkgproxy addr=:8080
 sudo snap set pkgproxy lxd-tls-addr=:8443


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

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 → 113
9 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 → 4
19 Aug 2026, 12:15 UTC
0+git13.a6eb447 (3)
19 Aug 2026, 09:15 UTC

Published19 Aug 2026, 08:45 UTC

Last updated19 Nov 2026, 15:17 UTC

First seen19 Aug 2026, 09:15 UTC