---
title: Install PkgProxy on Linux | Snap Store
description: Get the latest version of PkgProxy for Linux - Caching proxy for apt
  archives, the snap store, and go modules
url: https://snapcraft.io/pkgproxy
---

# PkgProxy

[Zygmunt Krynicki (zygoon)](https://snapcraft.io/publisher/zygoon "View all snaps from Zygmunt Krynicki (zygoon)")

* [Zygmunt Krynicki (zygoon)](https://snapcraft.io/publisher/zygoon "View all snaps from Zygmunt Krynicki (zygoon)")

latest/stable v0.6.1

Install latest/stable of PkgProxy

---

**Install using the command line**

```
sudo snap install pkgproxy
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

---

### Package name

* pkgproxy

---

### License

* Apache-2.0

---

### Last updated

* 13 September 2026 - latest/stable
* 13 September 2026 - latest/edge

---

### Websites

* [gitlab.com/zygoon/pkgproxy](https://gitlab.com/zygoon/pkgproxy "https://gitlab.com/zygoon/pkgproxy")

---

### Contact

* [me@zygoon.pl](mailto:me@zygoon.pl "mailto:me@zygoon.pl")

---

### Source code

* [gitlab.com/zygoon/pkgproxy](https://gitlab.com/zygoon/pkgproxy "https://gitlab.com/zygoon/pkgproxy")

---

### Command › Alias

* pkgproxy.pkgproxyctl › pkgproxyctl

---

### Report a bug

* [gitlab.com/zygoon/pkgproxy/-/issues](https://gitlab.com/zygoon/pkgproxy/-/issues "https://gitlab.com/zygoon/pkgproxy/-/issues")

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/pkgproxy#report-snap-modal)

---

* [Description](https://snapcraft.io/pkgproxy#tab-description)
* [Security](https://snapcraft.io/pkgproxy#tab-security)

#### Caching proxy for apt archives, the snap store, and go modules

pkgproxy caches packages for apt, snapd, and go module clients, sharing
one listener and one persistent cache.

For apt, traffic is proxied between clients and upstream Debian/Ubuntu-style
package archives over plain HTTP. Pool package content is cached
indefinitely; suite metadata (Release/InRelease/Packages/Sources), which
archives republish regularly, is instead revalidated against the origin
and the suite's own declared hashes, with a pkgproxyctl command to evict
an entry immediately. Requests are normalized across equivalent mirrors,
so that many mirror hosts serving the same archive collapse onto a single
backing-store entry. Point apt at it with Acquire::http::Proxy (or the
http\_proxy environment variable) and keep your sources.list entries naming
their real http:// mirrors. HTTPS-only apt sources still reach their real
host through a blind CONNECT tunnel (port 443 only) rather than being
cached.

For snapd, requests are relayed to the real snap store while .snap
downloads and assertions are cached, content-addressed by sha3-384 with
hash-verify-before-cache. Point snapd at it with SNAPPY\_FORCE\_API\_URL.

For go modules, pkgproxy acts as a reverse-origin GOPROXY, chaining to an
upstream module proxy (proxy.golang.org by default) on a cache miss. Point
the go command at it by setting GOPROXY.

The proxy listens on port 3142 by default and keeps its cache in the snap's
persistent data directory, so the cache survives updates. The service
starts automatically and needs no further configuration on the snap side.

Run `pkgproxy.pkgproxyctl setup apt`, `setup snap`, or `setup go` for
copy-paste-ready instructions on pointing that client at pkgproxy, or
`setup lxd` to configure an LXD profile so containers route their apt,
snap, and go module traffic through it too. Run on a terminal for
human-friendly guidance, or pipe to `sh` for a one-liner that applies the
config directly, e.g. `pkgproxy.pkgproxyctl setup apt | sh`.

Run `pkgproxy.pkgproxyctl stats` to see what the cache is actually doing:
per-snap download/hit/revision counts and bandwidth saved, and the apt
pool files saving the most bandwidth.

---

## Install PkgProxy on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/pkgproxy/arch)

[### CentOS](https://snapcraft.io/install/pkgproxy/centos)

[### Debian](https://snapcraft.io/install/pkgproxy/debian)

[### elementary OS](https://snapcraft.io/install/pkgproxy/elementary)

[### Fedora](https://snapcraft.io/install/pkgproxy/fedora)

[### KDE Neon](https://snapcraft.io/install/pkgproxy/kde-neon)

[### Kubuntu](https://snapcraft.io/install/pkgproxy/kubuntu)

[### Manjaro](https://snapcraft.io/install/pkgproxy/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/pkgproxy/pop)

[### openSUSE](https://snapcraft.io/install/pkgproxy/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/pkgproxy/rhel)

[### Ubuntu](https://snapcraft.io/install/pkgproxy/ubuntu)

[### Raspberry Pi](https://snapcraft.io/install/pkgproxy/raspbian)