ipv6
Enable or disable IPv6 on the server, or set a static IPv6 address with NetworkManager
- Command:
/go/ipv6 - Category: Network
- Required arguments: None. With no argument it enables IPv6.
- Optional argument:
disable(or0,--disable), or an IPv6 address - Output: The server's IPv6 address, a waiting message, or NetworkManager's output
- Last updated: 2026-11-19
On this page: Overview · Quick start · Requirements · Syntax · Output · Examples · Troubleshooting · Details · See also
Overview
/go/ipv6 has three jobs:
- Enable IPv6 in the kernel (the default).
- Disable IPv6 in the kernel, and keep it off after a reboot.
- Configure a static IPv6 address on the server's network connection with NetworkManager.
Every run first clears the panel's cache folder, /usr/local/goadmio/cache/*.
Quick start
# Enable IPv6
/go/ipv6
# Disable IPv6
/go/ipv6 disable
# Set a static IPv6 address (without a prefix length)
/go/ipv6 2a01:db8:1234:5678::1
Requirements
- Setting a static address needs NetworkManager (the
nmclicommand). Servers that useifupdown, Netplan, orsystemd-networkdare not supported by that form. For Proxmox servers seeinterfaces. - The final check uses
curland needs IPv6 connectivity toicanhazip.com. - The command uses
sudofor its changes.
Syntax
/go/ipv6
/go/ipv6 disable
/go/ipv6 <ipv6-address>
| Form | Behavior |
|---|---|
/go/ipv6 |
Enables IPv6, then shows the server's IPv6 address or a waiting message. |
/go/ipv6 disable (also 0 or --disable) |
Disables IPv6, now and after a reboot. |
/go/ipv6 <ipv6-address> |
Sets a static address on the first active NetworkManager connection, and reconnects it. |
[!WARNING] Any other value enables IPv6, including a typo such as
disabel. Any value that contains a colon is treated as an address.
[!WARNING] The address form re-activates the network connection. This can interrupt your SSH session for a few seconds.
Arguments
| Argument | Required | Default | Notes |
|---|---|---|---|
disable, 0, --disable |
No | — | Disables IPv6. |
<ipv6-address> |
No | — | Any value containing :. Give the address without a prefix length. The command adds /64. |
The command has no other options.
Output
| Form | What you get |
|---|---|
| Enable, IPv6 works | IPv6: <address>, the address the server uses to reach the internet over IPv6. |
| Enable, IPv6 not working yet | Please wait up to 3 minutes to activate IPv6... |
| Disable | The sysctl lines net.ipv6.conf.all.disable_ipv6 = 1 (and the same for default and lo). Nothing more if IPv6 is off. |
| Static address | The output of nmcli, such as Connection successfully activated. The exit code is 1. |
If an IPv6: line still appears after disable, IPv6 was not really switched off.
Logging
Every run is appended to /var/log/go/ipv6.log.
Examples
# Enable IPv6 and check the address
/go/ipv6
# Disable IPv6
/go/ipv6 disable
# Set a static address
/go/ipv6 2a01:db8:1234:5678::1
# Check the result
ip -6 addr show
ip -6 route show default
cat /etc/sysctl.d/99-disable-ipv6.conf
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
Please wait up to 3 minutes to activate IPv6... |
IPv6 was just enabled, or the server has no IPv6 connectivity. | Wait, then check ip -6 addr. If there is no global address, set one with the address form. |
| The SSH session dropped while setting an address | The connection is re-activated. | Reconnect. If IPv4 is lost, use the provider's console. |
nmcli: command not found, or the address is not applied |
NetworkManager isn't used on this server. | Configure IPv6 in the server's own network files. |
| A static address has no effect | IPv6 is disabled in the kernel by an earlier disable. |
Run /go/ipv6 first. |
An error such as invalid IP address, or /64/64 |
The value isn't a valid address, or it already includes a prefix. | Give only the address, for example 2a01:db8::1. |
| IPv6 connectivity fails with the static address | The gateway and DNS values are fixed and fit one provider's network. | Check your provider's values and change them with nmcli. |
| IPv6 turned on after a mistyped word | Any other value enables IPv6. | Run the command with the correct word. |
Services fail to start after disable |
They listen on an IPv6 address such as ::1. |
Change their configuration, or run /go/ipv6 to enable IPv6 again. |
| The command seems to hang at the end | curl waits for a broken IPv6 route. |
Press Ctrl+C. The settings are already applied. |
| The panel is slow right after running it | Its cache was cleared. | Expected. |
| Another connection was changed | The first active connection isn't always the main interface. | Check with nmcli connection show --active. |
Details
What it does
-
Logs the call, and deletes
/usr/local/goadmio/cache/*. -
Address form (the argument contains
:): takes the first active NetworkManager connection and sets:ipv6.method manualipv6.addresses <address>/64(this replaces any other IPv6 addresses on the connection)ipv6.gateway fe80::1ipv6.dns 2a01:4ff:ff00::add:1(this replaces any other IPv6 resolvers)- an on-link route to
fe80::1/128with metric100
It then re-activates the connection and exits with code
1. -
Disable form: writes
/etc/sysctl.d/99-disable-ipv6.confwithdisable_ipv6=1forall,default, andlo, and applies it at once withsysctl -p. -
Enable form (everything else): deletes that file and sets
disable_ipv6=0forall,default, andloat once. -
For the enable and disable forms: asks
icanhazip.comfor the server's IPv6 address. PrintsIPv6: <address>if one comes back. After enabling without an address, prints the waiting message.
The gateway fe80::1 and the DNS server 2a01:4ff:ff00::add:1 look like the standard values of one hosting provider. Other providers use different ones.
flowchart TD
A["ipv6 argument"] --> B["Clear panel cache"]
B --> C{"Argument"}
C -- "contains colon" --> D["Set static address with nmcli, reconnect, exit 1"]
C -- "disable, 0, --disable" --> E["Write sysctl file, disable IPv6"]
C -- "anything else" --> F["Remove sysctl file, enable IPv6"]
E --> G["Look up IPv6 address"]
F --> G
G --> H{"Address found?"}
H -- "Yes" --> I["Print IPv6: address"]
H -- "No, after enable" --> J["Print waiting message"]
Notes for maintainers
| Issue | Why it matters | Suggested fix |
|---|---|---|
The gateway, the DNS server, and the /64 prefix are fixed |
They fit one provider, and can break IPv6 elsewhere. | Make them options, or read them from the provider. |
| Any unrecognized argument enables IPv6 | A typo changes the server's network. | Accept only known words, and print usage. |
An argument with : is accepted as an address and gets /64 added |
Invalid values, or values that already have a prefix, fail after ipv6.method manual is already set, leaving the connection half-configured. |
Validate the address first, and accept address/prefix. |
nmcli connection up re-activates the whole connection |
Can drop SSH and IPv4. | Use nmcli device reapply, or add a rollback timer. |
| The first active connection is used | It can be the wrong interface, for example lo. |
Use the device of the default route. |
| NetworkManager is assumed | Nothing happens on ifupdown, Netplan, or systemd-networkd servers. |
Detect the network manager and stop with a clear message. |
The address form doesn't undo an earlier disable |
The address has no effect while the sysctl file is in place. | Remove the file and set the sysctl values first. |
ipv6.addresses and ipv6.dns are replaced, not added |
Existing addresses and resolvers are lost. | Use +ipv6.addresses and +ipv6.dns where that is wanted. |
disable changes the kernel only |
Services configured for IPv6 can fail to start. | Warn about it, or check the common services' settings. |
curl -6 has no time limit |
The command can wait a long time on a broken route. | Add --max-time. |
| The cache is cleared on every run | Unrelated to the requested action. | Clear it only when something changes. |
Exit code is 1 after a successful address change |
Callers see failure. | Use exit 0. |
See also
| Command | Description |
|---|---|
interfaces |
Create an interfaces file for Proxmox |
resolver |
Change the DNS resolver in GoAdmio |
reversedns |
Check reverse DNS (rDNS) in GoAdmio |
firewall |
Install a firewall on a GoAdmio server |
cache |
Clear cached data files to free space and refresh state |
hostname |
Change the hostname in GoAdmio |