Skip to content

AWG Admin v1.4.0

Choose a tag to compare

@ks-tool ks-tool released this 03 Sep 04:45
· 22 commits to main since this release

v1.4.0

New

  • Import existing wg-quick / awg-quick interfaces (#8, #15). Interfaces brought up on a server before the agent was installed are now discovered and shown on the server page with a Not managed badge (read-only), and can be taken over with a one-off import:
    • the agent reads the interface's conf from the server (/etc/amnezia/amneziawg/<name>.conf, then /etc/wireguard/<name>.conf); the file is the source of truth;
    • a peer map (user: / indented private-key: peer name) assigns the conf's peers to users — matched by exact name, created when missing; peers left out are imported without a user and keep working;
    • Preview dry-runs the import: interface, users (new / existing) and peers, the conf's hook commands, the hook commands the import generates (the routes wg-quick added implicitly, as idempotent ip route replace / del … || true hooks, incl. Table = N), and warnings (non-idempotent hooks, DNS changing meaning, SaveConfig ignored, peers without keepalive, link-type mismatch, …);
    • the interface, users and peers are written in one transaction, then pushed to the agent like any other change; a live interface is adopted in place, a downed one is created.
    • Creating or renaming an interface to the name of an unmanaged one is refused, since the push would overwrite the wg-quick link.
    • Available from the agent dialog (Import interface) and from the unmanaged interface's card; hidden for a containerized agent. See the guide section "Importing a wg-quick / awg-quick interface" for the seamless vs. clean migration paths and the wg-quick unit clean-up.
  • Save client config to a file from the peer QR-code modal (#14): the same config the QR encodes can be saved as a ready-to-import .conf (native save dialog on desktop, written 0600; browser download on the web).

Requirements

  • The import feature needs agent/v1.2.0 or newer on the server (new /interfaces/unmanaged and /interfaces/{name}/import-source endpoints; agent/v1.2.0 also fixes device enumeration on amneziawg-dkms v3.0 hosts, #11). With an older agent the unmanaged list is simply empty and the import reports that the conf can't be read.
  • The admin now depends on the published agent v1.2.0 module.