Skip to content →

APT repository

Charles has an APT repository for Debian-based Linux distributions.

NB: The keys for the repo changed on 26 July 2016, to utilise a larger key size and stronger digests. Existing users of the APT repository will need to import the new public key. The new public key is at the same URL as the old public key, therefore repeat the apt-key add step below to add it. Finally, run apt-get update to use the new key.

First install the GPG public key for the repository so you can verify that the packages are correctly signed. The current public key id is 1AD28806 and its fingerprint is 4BA7 DB85 7B57 0089 7420  96E1 5F16 B97C 1AD2 8806:

wget -qO- https://www.charlesproxy.com/packages/apt/charles-repo.asc | sudo tee /etc/apt/keyrings/charles-repo.asc

or alternatively:

sudo apt-key adv --keyserver pgp.mit.edu --recv-keys 1AD28806

Then add the repository to your sources:

sudo sh -c 'echo deb [signed-by=/etc/apt/keyrings/charles-repo.asc] https://www.charlesproxy.com/packages/apt/ charles-proxy main > /etc/apt/sources.list.d/charles.list'

Then update your sources and install Charles:

sudo apt-get update && sudo apt-get install charles-proxy

The package creates a charles command in /usr/bin, and adds Charles in your application menus in your window manager.

You may also install the beta track of Charles which is called charles-proxy-beta.

Charles 3

To install Charles 3, use the package charles-proxy3. You can have both Charles 4 and Charles 3 installed at the same time.

The package creates a "charles3" command in /usr/bin, and adds Charles in your application menues in your window manager.