GoAdmio

ipv6

Enable or disable IPv6 on the server, or set a static IPv6 address with NetworkManager

On this page: Overview · Quick start · Requirements · Syntax · Output · Examples · Troubleshooting · Details · See also


Overview

/go/ipv6 has three jobs:

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


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

  1. Logs the call, and deletes /usr/local/goadmio/cache/*.

  2. Address form (the argument contains :): takes the first active NetworkManager connection and sets:

    • ipv6.method manual
    • ipv6.addresses <address>/64 (this replaces any other IPv6 addresses on the connection)
    • ipv6.gateway fe80::1
    • ipv6.dns 2a01:4ff:ff00::add:1 (this replaces any other IPv6 resolvers)
    • an on-link route to fe80::1/128 with metric 100

    It then re-activates the connection and exits with code 1.

  3. Disable form: writes /etc/sysctl.d/99-disable-ipv6.conf with disable_ipv6=1 for all, default, and lo, and applies it at once with sysctl -p.

  4. Enable form (everything else): deletes that file and sets disable_ipv6=0 for all, default, and lo at once.

  5. For the enable and disable forms: asks icanhazip.com for the server's IPv6 address. Prints IPv6: <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