.. _wifi-connection:

Setting up a Wi-Fi Connection
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Prerequisites
""""""""""""""""""""

* Wi-Fi credentials of your network — SSID, password, etc.
* Administrative privileges for the gateway
* Console access to the gateway (either with a monitor/keyboard/mouse, SSH, or serial)
* Wi-Fi antennas (normally two RP-SMA female 2.4/5/6 GHz antennas for 2x2 MIMO) connected to the gateway

Steps
""""""

1. Ensure that you are currently logged in as the root user:

   .. code:: console

       $ sudo su

2. Ensure that your Wi-Fi network is visible to the gateway:

   .. code:: console

       $ nmcli device wifi list

3. Connect to the network using the command below. If your SSID or password contains certain special characters, enclose the password in quotes. If your SSID or password contains a quote itself, either use a different quote to enclose the password or escape it using a backslash:

   .. code:: console

       $ nmcli device wifi connect <WIFI_SSID> password <WIFI_PASSWORD>

4. Ensure you have connectivity and that you have an IP address assigned:

   .. code:: console

       $ ip a

5. Ensure that you have internet or intranet access by pinging a familiar server:

   .. code:: console

       $ ping 1.1.1.1