Aproxy Subordinate Charm

Platform:

Ubuntu
26.04 24.04 22.04 20.04
Channel Revision Published Runs on
latest/stable 87 27 May 2026
Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/stable 88 27 May 2026
Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/stable 89 27 May 2026
Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 332 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 331 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 330 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 329 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 328 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 327 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 326 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 325 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 324 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 323 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 322 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 321 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 320 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 319 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 318 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
latest/edge 317 19 Oct 2026
Ubuntu 26.04 Ubuntu 24.04 Ubuntu 22.04 Ubuntu 20.04
juju deploy aproxy --channel edge

How to back up and restore

The aproxy subordinate charm does not maintain application data or databases of its own. Since the charm is stateless apart from configuration, there is no persistent data that needs a traditional backup/restore procedure.

Back up

To preserve the state of the deployment, back up the following:

  1. Charm configuration

    Run:

    juju config aproxy
    

    Save the output, including:

    • proxy-address
    • exclude-addresses-from-proxy
    • intercept-ports
  2. System snapshot (optional)

    If required for compliance, you can also back up system-level state:

    • List of installed snaps (snap list)
    • nftables configuration (sudo nft list ruleset)

Restore

To restore the charm to its previous state:

  1. Redeploy the charm

    juju deploy aproxy --config proxy-address=<saved-address> \
                       --config exclude-addresses-from-proxy=<saved-exclude-addresses-from-proxy> \
                       --config intercept-ports=<saved-ports>
    
  2. (Optional) Reapply system snapshot

    • If you captured nftables or snap state for compliance, restore them with:

      sudo snap install aproxy --edge
      sudo nft -f <saved-ruleset-file>
      

In most cases, reapplying the saved Juju configuration is sufficient. The charm will automatically reinstall the snap and regenerate nftables rules.


Help improve this document in the forum (guidelines). Last updated 1 year, 8 days ago.