> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/key-croc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/key-croc/getting-the-key-croc-online.md).

# Getting the Key Croc Online

The Key Croc features an onboard WiFi module for connecting to nearby 2.4GHz networks. To configure WiFi, edit the `config.txt` file on the root of the Key Croc flash disk from Arming Mode.

The two WiFi parameters are:

* `WIFI_SSID` – the network name<br>
* `WIFI_PASS` – the WPA-PSK password

Any characters after these key words will be used as the values.&#x20;

## Protected Network

Example:

```
WIFI_SSID MyTargetNetwork
WIFI_PASS I'm not telling you.
```

{% hint style="warning" %}
**Some** special characters interpreted by bash may need to be escaped.
{% endhint %}

## Open Networks

{% hint style="info" %}
For **open networks** which do not require a password, **omit** the `WIFI_PASS` option.
{% endhint %}

## Resetting Wireless Configuration

{% hint style="danger" %}
To **disconnect** the Key Croc from a network, **remove** the `WIFI_SSID` and `WIFI_PASS` options, then restart the device.
{% endhint %}

## Overriding DNS

By default the Key Croc is configured to attempt to obtain an IP address from a network's DHCP server. Configuring a static IP address is outside the scope of this guide, however considering its Debian base this can be achieved in a number of ways.

The DNS server may be overridden from that obtained via DHCP by using the DNS option in `config.txt`, in the format:

```
DNS x.x.x.x x.x.x.x
```

To determine the IP address obtained by the Key Croc for development purposes, see the guide on Interactive Payload Development from the Tips section of this documentation.
