---
title: Charmhub | Deploy Aproxy Subordinate Charm using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of Aproxy Subordinate Charm on any cloud. A
  subordinate charm that deploys the aproxy application.
url: https://charmhub.io/aproxy
---

# Aproxy Subordinate Charm

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

26.04

24.04

22.04

20.04

stable 87

```
juju deploy aproxy
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Contact](https://launchpad.net/~canonical-is-devops)

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-devops)

* [Submit a bug](https://github.com/canonical/aproxy-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Aproxy operator

A [Juju](https://juju.is/) [charm](https://documentation.ubuntu.com/juju/3.6/reference/charm/) deploying and managing the [aproxy snap](https://snapcraft.io/install/aproxy/ubuntu) as a subordinate machine charm.

The aproxy charm installs and configures the aproxy snap and applies nftables rules to transparently intercept outbound TCP traffic from a principal charm, forwarding it through an upstream proxy.

Like any Juju charm, this charm supports one-line deployment, configuration, integration, scaling, and more.
For aproxy, this includes:

* Installing and configuring the aproxy snap.
* Enforcing nftables rules to transparently redirect outbound traffic.
* Forwarding TCP requests through a configurable upstream proxy.
* Supporting exclusions for specific destinations (`exclude-addresses-from-proxy`).
* Configurable interception ports (`intercept-ports`).

The aproxy charm is a subordinate and can be attached to any principal application to ensure its outbound traffic is transparently proxied. It runs on machines hosting the principal charm and is compatible with a wide range of Juju-managed environments.

This charm makes operating aproxy simple and straightforward for DevOps or SRE teams through Juju’s clean interface, ensuring consistent policy enforcement for egress traffic without requiring per-application configuration.

## [In this documentation](https://charmhub.io/aproxy#p-39642-in-this-documentation)

|  |  |
| --- | --- |
| [Tutorials](https://charmhub.io/aproxy/docs/tutorial)  Get started - a hands-on introduction to using the charm for new users | [How-to guides](https://charmhub.io/aproxy/docs/back-up-restore)   Step-by-step guides covering key operations and common tasks |
| [Reference](https://charmhub.io/aproxy/docs/integrations)   Technical information - specifications, APIs, architecture | [Explanation](https://charmhub.io/aproxy/docs/architecture)   Concepts - discussion and clarification of key topics |

## [Contributing to this documentation](https://charmhub.io/aproxy#p-39642-contributing-to-this-documentation)

Documentation is an important part of this project, and we take the same open-source approach
to the documentation as the code. As such, we welcome community contributions, suggestions, and
constructive feedback on our documentation.
See [How to contribute](https://charmhub.io/aproxy/docs/contribute) for more information.

If there’s a particular area of documentation that you’d like to see that’s missing, please
[file a bug](https://github.com/canonical/aproxy-operator/issues).

## [Project and community](https://charmhub.io/aproxy#p-39642-project-and-community)

The aproxy operator is a member of the Ubuntu family. It’s an open-source project that warmly welcomes community
projects, contributions, suggestions, fixes, and constructive feedback.

* [Code of conduct](https://ubuntu.com/community/code-of-conduct)
* [Get support](https://discourse.charmhub.io/)
* [Join our online chat](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)
* [Contribute](https://charmhub.io/aproxy/docs/contribute)

Thinking about using the aproxy operator for your next project?
[Get in touch](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)!

## [Contents](https://charmhub.io/aproxy#p-39642-contents)

1. How-to
2. Back up and restore
3. Configure
4. Contribute
5. Integrate with COS
6. Upgrade
7. Reference
8. Actions
9. Configurations
10. Integrations
11. Metrics
12. Explanation
13. Charm architecture
14. Security
15. Release notes
16. Overview

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/aproxy-operator-documentation-overview/19030) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated a year ago.