mac-server-setup¶
Scripts that turn a fresh Apple Silicon Mac mini into a home media server. You run one script on your own Mac, one on the Mac mini, and one more to install the apps. Every script is idempotent, so you can run it again after a failure.
The server runs Plex for a NAS full of media. Around it, you can add a download pipeline behind a VPN, a web dashboard with remote access, and watchdogs that email you when something breaks. Each of those parts is optional, and the stack matrix says what you can leave out or replace.
Start here: the get-started tutorial
How setup runs¶
flowchart LR
subgraph dev["Your Mac"]
prep["prep-airdrop.sh<br>builds the setup package"]
end
subgraph mini["Mac mini"]
fb["first-boot.sh<br>system, accounts, Homebrew"]
app["run-app-setup.sh<br>Plex and the optional apps"]
op["operator login<br>apps start"]
end
prep -- AirDrop --> fb --> app --> op
- Prep, on your Mac.
prep-airdrop.shreads your config and your 1Password items, and builds a package with keys and credentials. - First boot, on the Mac mini.
first-boot.shsets up the system, theoperatorservice account, SSH, and the Homebrew packages. - App setup, on the Mac mini.
run-app-setup.shinstalls Plex and any optional parts you chose. Whenoperatorlogs in, the apps start.
What runs on the server¶
flowchart TB
nas[("NAS<br>media share")]
plex["Plex Media Server"]
subgraph dl["Download pipeline (optional)"]
catch["Catch<br>RSS feeds"] --> tr["Transmission<br>in Podman, behind PIA VPN"]
tr --> fbot["FileBot<br>rename and file"]
end
subgraph edge["Remote access (optional)"]
cf["Cloudflare Tunnel<br>and Access"] --> caddy["Caddy<br>dashboard, media files,<br>Transmission web UI"]
end
watch["Watchdogs<br>alert email"]
nas --- plex
fbot --> nas
caddy --> tr
caddy --> nas
watch -.-> plex
watch -.-> tr
Where to go next¶
- New install: the get-started tutorial, eight pages from a spare Mac mini to the first play in Plex.
- Every config key: the configuration key reference.
- Why it is built this way: the explanation pages.
- Which parts you need: the stack matrix.
- The code: smartwatermelon/mac-server-setup.