aproxy

Aproxy Subordinate Charm

Channel Revision Published Runs on
latest/stable 7 17 Oct 2025
Ubuntu 24.04 Ubuntu 22.04
latest/stable 4 14 Oct 2025
Ubuntu 24.04 Ubuntu 22.04
latest/edge 10 27 Oct 2025
Ubuntu 24.04 Ubuntu 22.04
latest/edge 9 27 Oct 2025
Ubuntu 24.04 Ubuntu 22.04
juju deploy aproxy
Show information

Platform:

Ubuntu
24.04 22.04

Aproxy operator

A Juju charm deploying and managing the aproxy snap 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

Tutorials
Get started - a hands-on introduction to using the charm for new users
How-to guides
Step-by-step guides covering key operations and common tasks
Reference
Technical information - specifications, APIs, architecture
Explanation
Concepts - discussion and clarification of key topics

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 for more information.

If there’s a particular area of documentation that you’d like to see that’s missing, please file a bug.

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.

Thinking about using the aproxy operator for your next project? Get in touch!

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