Title: Connect to a Wi-Fi Network
Description: Connect GhostESP to a network you own or are authorized to use.
URL: /v2.1/wifi/connect/
Version: v2.1
Section: Wi-Fi
Search index: /search-index.json

# Connect to a Wi-Fi Network

> Connect GhostESP to a network you own or are authorized to use.

## On this page

- [What this does](#what-this-does)
- [Before you start](#before-you-start)
- [On-device steps](#on-device-steps)
- [CLI steps](#cli-steps)
- [Expected result](#expected-result)
- [Troubleshooting](#troubleshooting)
- [Related tasks](#related-tasks)

---

## What this does
Connect GhostESP to a Wi-Fi network so it can use network-dependent features. Connecting changes the board’s Wi-Fi mode and disconnects devices using the GhostNet access point.
## Before you start
- The network name and password.
- Permission to connect GhostESP to that network.
- A serial or on-device control method. The WebUI connection drops when the board changes Wi-Fi mode.
## On-device steps
- Open Menu → WiFi → Connection → Connect to WiFi.
- Enter the network name and password.
- Wait for the connection status to confirm success.
- To disconnect later, open Menu → WiFi → Connection → Disconnect.
## CLI steps
- Run connect "SSID" "password". Keep the quotes when either value contains spaces.
- Wait for the connection status.
- Run connect without arguments to reconnect to the saved network.
- Run disconnect to leave the network.
## Expected result
GhostESP reports that it is connected. The GhostNet access point is unavailable while the board uses its Wi-Fi radio as a client.
## Troubleshooting
- Connection fails: Recheck the network name and password, then move closer to the access point.
- The WebUI disconnects: This is expected. Use serial or the on-device UI while GhostESP is connected to another network.
- The board reconnects to the wrong network: Run disconnect, then use connect "SSID" "password" with the intended network.
## Related tasks
- [Scan nearby Wi-Fi networks](/v2.1/wifi/survey/)
- [Find devices on your Wi-Fi network](/v2.1/wifi/lan-discovery/)
- [Connect to GhostESP](/v2.1/getting-started/control-methods/)