Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.1Mb
PDF (A4) - 35.2Mb
Man Pages (TGZ) - 256.4Kb
Man Pages (Zip) - 361.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

MySQL 5.7 Reference Manual  / ...  / MySQL Server Administration  / The MySQL Server  / IPv6 Support  /  Connecting Using the IPv6 Local Host Address

5.1.12.3 Connecting Using the IPv6 Local Host Address

The following procedure shows how to configure MySQL to permit IPv6 connections by clients that connect to the local server using the::1 local host address. The instructions given here assume that your system supports IPv6.

  1. Start the MySQL server with an appropriatebind_address setting to permit it to accept IPv6 connections. For example, put the following lines in the server option file and restart the server:

    [mysqld]bind_address = *

    Alternatively, you can bind the server to::1, but that makes the server more restrictive for TCP/IP connections. It accepts only IPv6 connections for that single address and rejects IPv4 connections. For more information, see thebind_address description inSection 5.1.7, “Server System Variables”.

  2. As an administrator, connect to the server and create an account for a local user who connects from the::1 local IPv6 host address:

    mysql> CREATE USER 'ipv6user'@'::1' IDENTIFIED BY 'ipv6pass';

    For the permitted syntax of IPv6 addresses in account names, seeSection 6.2.4, “Specifying Account Names”. In addition to theCREATE USER statement, you can issueGRANT statements that give specific privileges to the account, although that is not necessary for the remaining steps in this procedure.

  3. Invoke themysql client to connect to the server using the new account:

    $> mysql -h ::1 -u ipv6user -pipv6pass
  4. Try some simple statements that show connection information:

    mysql> STATUS...Connection:   ::1 via TCP/IP...mysql> SELECT CURRENT_USER(), @@bind_address;+----------------+----------------+| CURRENT_USER() | @@bind_address |+----------------+----------------+| ipv6user@::1   | ::             |+----------------+----------------+