NixOS / NixOS/nix.dev

NixOS install guide for Raspberry Pi misses step in installation using wifi

Open
#1,167 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

site
Dominant language
Nix
Stars
4k
Forks
339
Avg merge
2d 11h
Merged PRs (30d)
7

Description

Observations

I recently followed this guide (with the most recent hydra image) on installing NixOS on a Raspberry Pi 400. Setting up a wireless connection at the 'Getting internet connection' step did not actually connect to the internet yet. I had to first assign a static ip address to my wlan0 using the following commands:

sudo ip addr add <ipaddress> dev wlan0
sudo ip route add default via <ipaddress>

This allowed me to set up a nix shell to assign a regular ip address with dhcpcd

nix-shell -p dhcpcd
sudo dhcpcd wlan0

And the guide could be completed.

Also, the guide currently mentions to use iwconfig to find the network interface, but this program isn't available when first booting.

Problem

The guide misses a step to assign an ip address to the network interface and incorrectly assumes that iwconfig is available.

Approaches

A step needs to be inserted that explains how to assign an ip address to the wireless interface. It could be that this issue doesn't show up everywhere, but it would at least be good to mention it in the guide. Replacing iwconfig with ip link would also be an improvement

Willing to help?

Of course

Priorities

Add 👍 to issues you find important.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open the linked NixOS-on-Raspberry-Pi installation guide and read its “Getting internet connection” section. Verify the first-boot availability of iwconfig and the reported wlan0 setup, then document the needed IP/DHCP step and use ip link for interface discovery. Done when a fresh Wi-Fi installation can continue to the nix-shell step without relying on unavailable iwconfig.

Written by the indexing model from the issue text.

Assessment

Tech stack
raspberry-pi
Domain
documentation, networking, operating-systems
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.