amnezia-vpn/amnezia-client

Fork 0

mirror of https://github.com/amnezia-vpn/amnezia-client.git synced 2026-10-15 13:52:15 +00:00

[GH-ISSUE #2534] docs: add "Community Tools" section linking CLI/headless install solutions #1144

New issue

Open

opened 2026-10-13 20:35:13 +00:00 by bsakaguchi · 4 comments

bsakaguchi commented

2026-10-13 20:35:13 +00:00

Owner

Originally created by @bivlked on GitHub (Apr 26, 2026).
Original GitHub issue: https://github.com/amnezia-vpn/amnezia-client/issues/2534

Hi team,

Following up on Discussion #2356 (15 Mar, 4 upvotes), which has been open without a maintainer reply for about 35 days. Filing as an Issue with the documentation label per the repo's existing classification — hopefully easier to triage than an [Ideas] discussion.

Why a docs section is worth it

A repeating pattern shows up across this repo and adjacent forums — users want CLI / headless AmneziaWG on Linux servers, separate from the desktop client:

#850 "Headless installation & CLI interface?" — 81 reactions, open since June 2024
Discussion #2124 "Debian 13 / Kernel Module tutorial"
Discussion #2470 "client-to-client over AWG2.0 own VPS" — Q&A, 13 days silence
forum.qubes-os.org/t/39005 — 2.4k views
Same questions surface in Reddit r/AmneziaVPN and ntc.party

Right now docs.amnezia.org doesn't point readers anywhere for self-hosted server setup, so people reinvent the wheel.

Concrete proposal

Add a short "Community Tools" section under the existing server docs. Draft:

Community Tools

For Linux administrators who prefer command-line setup over the desktop client, the community maintains several tools:

amneziawg-installer (Bash, Ubuntu/Debian + ARM) — one-command kernel-native server install with client management, vpn:// QR import, mobile-carrier DPI preset

amneziawg-go — userspace implementation for environments without kernel modules (LXC, restricted hosts)

amneziawg-tools — awg / awg-quick CLI utilities

Affiliation

I maintain amneziawg-installer (one of the tools listed). Happy to submit a PR with this section + descriptions, or just provide the content for your team to integrate.

Originally created by @bivlked on GitHub (Apr 26, 2026). Original GitHub issue: https://github.com/amnezia-vpn/amnezia-client/issues/2534 Hi team, Following up on Discussion #2356 (15 Mar, 4 upvotes), which has been open without a maintainer reply for about 35 days. Filing as an Issue with the `documentation` label per the repo's existing classification — hopefully easier to triage than an [Ideas] discussion. **Why a docs section is worth it** A repeating pattern shows up across this repo and adjacent forums — users want CLI / headless AmneziaWG on Linux servers, separate from the desktop client: - #850 "Headless installation & CLI interface?" — 81 reactions, open since June 2024 - Discussion #2124 "Debian 13 / Kernel Module tutorial" - Discussion #2470 "client-to-client over AWG2.0 own VPS" — Q&A, 13 days silence - forum.qubes-os.org/t/39005 — 2.4k views - Same questions surface in Reddit r/AmneziaVPN and ntc.party Right now docs.amnezia.org doesn't point readers anywhere for self-hosted server setup, so people reinvent the wheel. **Concrete proposal** Add a short "Community Tools" section under the existing server docs. Draft: > **Community Tools** > > For Linux administrators who prefer command-line setup over the desktop client, the community maintains several tools: > > - **amneziawg-installer** (Bash, Ubuntu/Debian + ARM) — one-command kernel-native server install with client management, vpn:// QR import, mobile-carrier DPI preset > - **amneziawg-go** — userspace implementation for environments without kernel modules (LXC, restricted hosts) > - **amneziawg-tools** — `awg` / `awg-quick` CLI utilities **Affiliation** I maintain amneziawg-installer (one of the tools listed). Happy to submit a PR with this section + descriptions, or just provide the content for your team to integrate.

bsakaguchi commented

2026-10-13 20:35:14 +00:00

Author

Owner

@igr-noob commented on GitHub (May 22, 2026):

How do I use vless if I deployed amneziawg-go and amneziawg-tools on a Raspberry Pi (ARM)?
What is amneziawg-installer (... Debian + ARM)?

@igr-noob commented on GitHub (May 22, 2026): How do I use vless if I deployed amneziawg-go and amneziawg-tools on a Raspberry Pi (ARM)? What is amneziawg-installer (... Debian + ARM)?

bsakaguchi commented

2026-10-13 20:35:14 +00:00

Author

Owner

@bivlked commented on GitHub (May 24, 2026):

@igr-noob - VLESS and AmneziaWG are separate stacks, so a quick clarification:

VLESS is an Xray/v2ray protocol, not part of amneziawg-go / amneziawg-tools. You don't run VLESS "through" AmneziaWG - the Amnezia client app just bundles several protocols and lets you pick one per server. The WG tools themselves only speak AmneziaWG.
amneziawg-installer is a server-side bash installer I maintain for headless AmneziaWG 2.0 on dedicated Ubuntu / Debian servers, ARM included. It sets up amneziawg-go + amneziawg-tools, generates configs / QR / vpn:// URIs and a manage CLI. On a Raspberry Pi it gives you an AmneziaWG server, not a VLESS one.

This is actually a good example of why a Community Tools section would help - the CLI / headless path isn't obvious from the client docs today. If you specifically want VLESS on ARM, that's Xray-core territory (a different project).

@bivlked commented on GitHub (May 24, 2026): @igr-noob - VLESS and AmneziaWG are separate stacks, so a quick clarification: - **VLESS** is an Xray/v2ray protocol, not part of `amneziawg-go` / `amneziawg-tools`. You don't run VLESS "through" AmneziaWG - the Amnezia client app just bundles several protocols and lets you pick one per server. The WG tools themselves only speak AmneziaWG. - **amneziawg-installer** is a server-side bash installer I maintain for headless AmneziaWG 2.0 on dedicated Ubuntu / Debian servers, ARM included. It sets up `amneziawg-go` + `amneziawg-tools`, generates configs / QR / vpn:// URIs and a `manage` CLI. On a Raspberry Pi it gives you an AmneziaWG server, not a VLESS one. This is actually a good example of why a Community Tools section would help - the CLI / headless path isn't obvious from the client docs today. If you specifically want VLESS on ARM, that's Xray-core territory (a different project).

bsakaguchi commented

2026-10-13 20:35:14 +00:00

Author

Owner

@igr-noob commented on GitHub (May 26, 2026):

Иван, привет!

Спасибо за пояснение.

вс, 24 мая 2026 г. в 22:50, Ivan Bondarev @.***>:

bivlked left a comment (amnezia-vpn/amnezia-client#2534)
https://github.com/amnezia-vpn/amnezia-client/issues/2534#issuecomment-4529789460

@igr-noob https://github.com/igr-noob - VLESS and AmneziaWG are
separate stacks, so a quick clarification:

VLESS is an Xray/v2ray protocol, not part of amneziawg-go /
amneziawg-tools. You don't run VLESS "through" AmneziaWG - the Amnezia
client app just bundles several protocols and lets you pick one per server.
The WG tools themselves only speak AmneziaWG.

amneziawg-installer is a server-side bash installer I maintain for
headless AmneziaWG 2.0 on dedicated Ubuntu / Debian servers, ARM included.
It sets up amneziawg-go + amneziawg-tools, generates configs / QR /
vpn:// URIs and a manage CLI. On a Raspberry Pi it gives you an
AmneziaWG server, not a VLESS one.

This is actually a good example of why a Community Tools section would
help - the CLI / headless path isn't obvious from the client docs today. If
you specifically want VLESS on ARM, that's Xray-core territory (a different
project).

—
Reply to this email directly, view it on GitHub
https://github.com/amnezia-vpn/amnezia-client/issues/2534#issuecomment-4529789460,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/BOGQDJFR5CXXLOFFMIWVFHD44NG65AVCNFSM6AAAAACYHB44XCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DKMRZG44DSNBWGA
.
Triage notifications on the go with GitHub Mobile for iOS
https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675
or Android
https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub.

You are receiving this because you were mentioned.Message ID:
@.***>

@igr-noob commented on GitHub (May 26, 2026): Иван, привет! Спасибо за пояснение. вс, 24 мая 2026 г. в 22:50, Ivan Bondarev ***@***.***>: > *bivlked* left a comment (amnezia-vpn/amnezia-client#2534) > <https://github.com/amnezia-vpn/amnezia-client/issues/2534#issuecomment-4529789460> > > @igr-noob <https://github.com/igr-noob> - VLESS and AmneziaWG are > separate stacks, so a quick clarification: > > - > > *VLESS* is an Xray/v2ray protocol, not part of amneziawg-go / > amneziawg-tools. You don't run VLESS "through" AmneziaWG - the Amnezia > client app just bundles several protocols and lets you pick one per server. > The WG tools themselves only speak AmneziaWG. > - > > *amneziawg-installer* is a server-side bash installer I maintain for > headless AmneziaWG 2.0 on dedicated Ubuntu / Debian servers, ARM included. > It sets up amneziawg-go + amneziawg-tools, generates configs / QR / > vpn:// URIs and a manage CLI. On a Raspberry Pi it gives you an > AmneziaWG server, not a VLESS one. > > This is actually a good example of why a Community Tools section would > help - the CLI / headless path isn't obvious from the client docs today. If > you specifically want VLESS on ARM, that's Xray-core territory (a different > project). > > — > Reply to this email directly, view it on GitHub > <https://github.com/amnezia-vpn/amnezia-client/issues/2534#issuecomment-4529789460>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/BOGQDJFR5CXXLOFFMIWVFHD44NG65AVCNFSM6AAAAACYHB44XCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DKMRZG44DSNBWGA> > . > Triage notifications on the go with GitHub Mobile for iOS > <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> > or Android > <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub>. > > You are receiving this because you were mentioned.Message ID: > ***@***.***> >

bsakaguchi commented

2026-10-13 20:35:14 +00:00

Author

Owner

@bivlked commented on GitHub (May 28, 2026):

@igr-noob - пожалуйста, рад если помогло.

И по теме самого Issue: если проект решит принять Community Tools раздел в документации, я готов помочь описанием headless server-side пути для AmneziaWG. Это будет полезно тем, кому нужна именно AWG-серверная сторона, а не клиентский билд.

@bivlked commented on GitHub (May 28, 2026): @igr-noob - пожалуйста, рад если помогло. И по теме самого Issue: если проект решит принять Community Tools раздел в документации, я готов помочь описанием headless server-side пути для AmneziaWG. Это будет полезно тем, кому нужна именно AWG-серверная сторона, а не клиентский билд.

No labels

pull-request

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

amnezia-vpn/amnezia-client#1144

No description provided.

Rows
Columns

[GH-ISSUE #2534] docs: add "Community Tools" section linking CLI/headless install solutions #1144

VLESS is an Xray/v2ray protocol, not part of amneziawg-go / amneziawg-tools. You don't run VLESS "through" AmneziaWG - the Amnezia client app just bundles several protocols and lets you pick one per server. The WG tools themselves only speak AmneziaWG.

VLESS is an Xray/v2ray protocol, not part of amneziawg-go /
amneziawg-tools. You don't run VLESS "through" AmneziaWG - the Amnezia
client app just bundles several protocols and lets you pick one per server.
The WG tools themselves only speak AmneziaWG.