Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save dialupdev/8f74c76a641310462ab3 to your computer and use it in GitHub Desktop.
Save dialupdev/8f74c76a641310462ab3 to your computer and use it in GitHub Desktop.
Setting up headless Raspberry Pi OS on macOS

Download the latest Raspbian Lite image from https://www.raspberrypi.org/downloads/raspbian/ (2019-09-26 at the time of this writing).

Insert your microSD card. Use balenaEtcher to burn the image to your microSD card.

Ensure the disk is mounted again, then enable SSH.

$ touch /Volumes/boot/ssh

If you're planning on using the built-in WiFi on the Raspberry Pi 3/Zero W or an Edimax EW-7811Un USB Wifi adapter (rtl8188cus chipset), add your Wifi configuration. Create the following file:

$ nano /Volumes/boot/wpa_supplicant.conf

And add this to it:

country=US
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
	ssid="[SSID]"
	psk="[password]"
}

Eject your SD card and insert it into your Pi.

Plug in your Pi and give it a minute to boot and connect to your network, either over Wifi or ethernet.

Copy your public SSH key the the Pi.

$ cat ~/.ssh/id_rsa.pub | ssh [email protected] "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

Configure your Pi.

$ ssh [email protected]

$ sudo raspi-config

That's it! 🏆

@artburkart
Copy link

Awesome, thanks for sharing :)

@dialupdev
Copy link
Author

Glad you found it useful!

@johanndiedrick
Copy link

Thank you so much for this!

@spicymaya
Copy link

Really great. Thank you! Made the set up so quick and easy!

@theoctober19th
Copy link

I followed every steps, but cannot ssh to [email protected] because it asks for password. Tried raspberry but didn't work.

@dialupdev
Copy link
Author

Thanks for pointing this out @theoctober19th. In the latest version of Raspberry Pi OS (2022-04-04), the "pi" user has been removed. I've just updated the section about writing the image with instructions on how to create the "pi" user.

@arvindpant
Copy link

Thanks @celeryclub for making setup for easy:)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment