The Raspberry Pi 5 is the best Pi yet — faster processor, more RAM, an official active cooler, and a new PCIe slot that opens up serious storage options. Paired with your Mac, it makes for an incredibly capable and cheap home lab that can run a local server, host your own services, and teach you a ton about networking and Linux in the process.
In this guide, I'll walk through everything from initial setup to getting your Pi 5 working seamlessly alongside your Mac — including SSH access from Terminal, file sharing, running a local web server, and a few project ideas to get you started. I wrote about Raspberry Pi earlier on this blog — the Pi 5 is a significant leap forward.
What You'll Need
- Raspberry Pi 5 (4GB or 8GB RAM recommended) — available from Adafruit, PiShop.us, or CanaKit
- MicroSD card: At least 32GB, Class 10 or faster. A Samsung Endurance or SanDisk Extreme is recommended for reliability
- Official Raspberry Pi Power Supply (27W USB-C for Pi 5 — don't skimp on this)
- Official Raspberry Pi Active Cooler (comes with some kits, highly recommended for Pi 5)
- A case (optional but nice)
- Your Mac (any modern Mac works)
A complete CanaKit or official Raspberry Pi starter kit typically runs $70–$100 and includes everything except a monitor.
Step 1: Flash the Operating System
The easiest way to set up your Pi is using Raspberry Pi Imager on your Mac.
- Download Raspberry Pi Imager from the official Raspberry Pi website
- Install it on your Mac and open it
- Choose your device: Raspberry Pi 5
- Choose your OS: Raspberry Pi OS (64-bit) — the full version with desktop is good for beginners; Lite (no desktop) if you're running headless
- Choose your storage: select your microSD card
- Before writing, click the gear icon (Settings) — this is important:
- Set a hostname (e.g.,
raspberrypi.local) - Enable SSH
- Set a username and password
- Configure your Wi-Fi SSID and password (so it connects automatically on first boot)
- Set a hostname (e.g.,
- Click Write and wait for the image to be written and verified
These preconfigured settings mean your Pi will be on your network and accessible via SSH from the very first boot — no keyboard or monitor needed.
Step 2: First Boot and SSH from Your Mac
Insert the microSD card into your Pi, connect power, and wait about 60–90 seconds for first boot. Then, on your Mac:
- Open Terminal (Applications > Utilities > Terminal)
- Connect via SSH using the hostname you set:
ssh pi@raspberrypi.local
Replace pi with the username you chose during setup. You'll be prompted to accept the host fingerprint (type yes) and then enter your password.
If the hostname doesn't resolve, try using the Pi's IP address instead. You can find it by logging into your router's admin page and looking at connected devices.
Once connected, you're in. You're now controlling your Raspberry Pi from Terminal on your Mac — typing commands that run on the Pi over your local network.
Step 3: Update and Upgrade Your Pi
After first login, always update to the latest packages:
sudo apt update && sudo apt upgrade -y
This downloads and installs the latest security patches and software updates. It may take a few minutes. Run this regularly — it's the equivalent of running Software Update on your Mac.
Step 4: Set Up File Sharing Between Pi and Mac
To easily transfer files between your Mac and Pi, set up Samba (the protocol that makes file shares visible on macOS):
sudo apt install samba samba-common-bin -y
Then configure it to share your home folder:
sudo nano /etc/samba/smb.conf
Add this at the end of the file:
[PiShare]
path = /home/pi
writeable = yes
create mask = 0777
directory mask = 0777
public = no
Save with Control+O, Enter, Control+X, then set a Samba password for your user:
sudo smbpasswd -a pi
Restart Samba:
sudo systemctl restart smbd
Now on your Mac, open Finder, press Command+K, and type:
smb://raspberrypi.local
Enter your Pi's Samba credentials and you'll see the shared folder appear in Finder like any other network drive. Drag and drop files between your Mac and Pi freely.
Step 5: Run a Local Web Server
One of the most satisfying first Pi projects is hosting a local website or web app. Install Apache in seconds:
sudo apt install apache2 -y
That's it. Open a browser on your Mac and go to http://raspberrypi.local — you'll see the default Apache welcome page, confirming your web server is running.
Your website files live at /var/www/html/ on the Pi. Drop an HTML file there and it'll be served immediately. From your Mac, copy files there using the Samba share you set up, or via the command line with:
scp /path/to/local/file.html pi@raspberrypi.local:/var/www/html/
Combined with editing the hosts file on your Mac (which I've covered on this blog), you can point a custom local domain like myproject.local to your Pi's IP address for a more realistic local dev setup.
Step 6: Set a Static IP for Your Pi
For a reliable home lab, your Pi should always have the same IP address. The easiest way is to set a DHCP reservation in your router — look for "DHCP Reservations" in your router admin panel, find your Pi's MAC address, and assign it a permanent IP like 192.168.1.100.
Alternatively, set a static IP on the Pi itself by editing the DHCP configuration:
sudo nano /etc/dhcpcd.conf
Add at the end:
interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8
Adjust the IP addresses to match your network. Save, exit, and reboot the Pi: sudo reboot
Useful SSH and Terminal Tips for Mac Users
Create an SSH shortcut on your Mac
Instead of typing the full SSH command every time, add an alias to your shell. Open Terminal and edit your profile:
nano ~/.zshrc
Add:
alias pi="ssh pi@raspberrypi.local"
Save and run source ~/.zshrc. Now you can just type pi in Terminal to connect instantly.
Use SSH keys instead of a password
Generate an SSH key pair on your Mac (if you haven't already) and copy your public key to the Pi:
ssh-keygen -t ed25519 -C "your_mac@home"
ssh-copy-id pi@raspberrypi.local
After this, you can SSH into your Pi without ever typing a password — much more convenient.
Project Ideas for Your Pi + Mac Home Lab
- Pi-hole: A network-wide ad blocker that runs on your Pi and filters ads for every device on your home network — including your Mac, iPhone, and smart TV
- Local WordPress site: Install LAMP (Linux, Apache, MySQL, PHP) and run WordPress locally for development and testing before deploying to a live server
- Home automation hub: Run Home Assistant to control smart home devices without relying on cloud services
- Retro gaming: RetroPie turns your Pi into a retro gaming console supporting hundreds of classic systems
- Network monitor: Run tools like
nmapandiftopto see what's on your home network - Personal VPN: Set up WireGuard on your Pi so you can securely access your home network from anywhere
Conclusion
The Raspberry Pi 5 is an excellent companion to a Mac. It's cheap enough to experiment with freely, powerful enough to run real services, and a fantastic way to learn Linux and networking in your own home. The combination of Pi's Linux environment and your Mac's Terminal makes for a productive home lab that can grow with your skills.
The Raspberry Pi Foundation's official documentation is exceptionally well-written and covers everything from hardware specs to advanced project tutorials. It's the best place to go once you've got the basics running.
What project are you thinking of running on your Pi? Drop it in the comments — I'd love to hear what you're building.