1ec8cbf7d9
related to https://github.com/google/periph/issues/432 fixes https://github.com/gokrazy/gokrazy/issues/33
55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
---
|
||
title: "Connecting to unencrypted WiFi networks"
|
||
weight: 40
|
||
---
|
||
|
||
# Connecting to unencrypted WiFi networks
|
||
|
||
Remember that using an unencrypted WiFi network means anyone in range can read
|
||
your communication. Hence, we strongly recommend [using TLS for accessing the
|
||
gokrazy web interface and doing
|
||
updates](/userguide/tls-for-untrusted-networks/).
|
||
|
||
To make gokrazy connect to a WiFi network, first include the
|
||
`github.com/gokrazy/wifi` package in your `gokr-packer` command line, e.g.:
|
||
|
||
```shell
|
||
gokr-packer \
|
||
-tls=self-signed \
|
||
-update=yes \
|
||
github.com/gokrazy/hello \
|
||
github.com/gokrazy/breakglass \
|
||
github.com/gokrazy/serial-busybox \
|
||
github.com/gokrazy/wifi
|
||
```
|
||
|
||
Then, configure the `wifi` program by creating the file `wifi.json` on the
|
||
permanent data partition:
|
||
|
||
```shell
|
||
# The following assumes you already created a file system
|
||
# on the permanent data partition. Otherwise, please use:
|
||
# sudo mkfs.ext4 /dev/disk/by-partuuid/2e18c40c-04
|
||
|
||
sudo mount /dev/disk/by-partuuid/2e18c40c-04 /mnt
|
||
echo '{"ssid": "I/O Tee"}' | sudo tee /mnt/wifi.json
|
||
sudo umount /mnt
|
||
```
|
||
|
||
After starting gokrazy, the `wifi` program will connect to the WiFi network `I/O
|
||
Tee`:
|
||
|
||
<a href="/img/2020-05-27-gokrazy-wifi-unencrypted.jpg"><img src="/img/2020-05-27-gokrazy-wifi-unencrypted.thumb.jpg" srcset="/img/2020-05-27-gokrazy-wifi-unencrypted.thumb.2x.jpg 2x,/img/2020-05-27-gokrazy-wifi-unencrypted.thumb.3x.jpg 3x" width="700" align="right" style="border: 1px solid grey; margin-bottom: 2em; margin-top: 1em"></a>
|
||
|
||
## For debugging: known-working WiFi router setup
|
||
|
||
In case you have trouble getting your Raspberry Pi to connect to your network,
|
||
this is how I set up my [TP-LINK
|
||
TL-WDR4300](https://openwrt.org/toh/tp-link/tl-wdr4300) with [OpenWrt
|
||
19.07](https://openwrt.org/):
|
||
|
||
<a href="/img/iotee.jpg"><img src="/img/iotee.thumb.jpg" srcset="/img/iotee.thumb.2x.jpg 2x,/img/iotee.thumb.3x.jpg 3x" width="700" align="right" style="border: 1px solid grey; margin-bottom: 2em; margin-top: 1em"></a>
|
||
|
||
The MAC address filter isn’t a security measure, but prevents others from
|
||
accidentally joining this open network.
|