Running a Mac mini as a home server is one of the cleanest, quietest, and most power‑efficient ways to self‑host apps. 

Before You Start

If you’re still deciding between Docker Desktop and OrbStack, check out Docker vs OrbStack for a Mac Home Server for a detailed comparison. This guide assumes you’ve chosen OrbStack and are ready to configure it for reliable, always‑on use.

---

Step 1: Download and Install OrbStack

Download the latest macOS build from orbstack.dev. Once downloaded, drag OrbStack into your Applications folder and launch it. On first launch, OrbStack will install required system components and ask for admin permissions to set itself as your default Docker environment. There’s no need to install Docker Desktop as OrbStack replaces it entirely.

---

Step 2: Configure OrbStack

OrbStack works best with a few simple settings enabled. Open OrbStack > Settings:

• General: Enable “Start OrbStack at login” and “Automatically start last used containers” to make your server behave like a real appliance.
• Docker: Turn on Docker compatibility so terminal commands like `docker` and `docker compose` work naturally.
• Resources: Leave CPU and memory on “Automatic” and enable swap — OrbStack dynamically manages resources for you.

---

Step 3: Networking Made Easy

OrbStack uses a custom virtual network stack that exposes container services directly to macOS without manual port forwarding. This means you can access applications using your Mac’s IP or localhost just like on a native system. 

• Containers bind to your Mac’s IP
• No port forwarding setup required
• Works with VPNs and DNS settings seamlessly

Example: Jellyfin at http://mac-mini.local:8096, Home Assistant at http://mac-mini.local:8123.

---

Step 4: Organize Your Data for Persistence

Before starting containers, create a dedicated folder for persistent data and point OrbStack’s VM storage to it. Centralizing data storage makes backups and restores trivial:

Orbstack → Preferences → Disk → Change Location → ~/server_data/orbstack

Here’s a recommended directory layout:

~/server_data/
├── jellyfin/
├── homeassistant/
├── adguard/
├── prometheus/
├── grafana/

Because containers are disposable by design, keeping data separate ensures it persists across container recreations and makes troubleshooting and backups much simpler.

---

Step 5: Launch Your First Container

OrbStack includes full Docker Compose support, so use your Compose files to define services in a clean, repeatable way.

version: "3.8"
services:
  adguard:
    image: adguard/adguardhome
    container_name: adguard
    restart: unless-stopped
    ports:
      - "3000:3000"
      - "53:53/tcp"
      - "53:53/udp"
    volumes:
      - ./work:/opt/adguardhome/work
      - ./conf:/opt/adguardhome/conf

To start it:

1. Open OrbStack > Docker > Compose > Add
2. Select the folder with your docker-compose.yml
3. Click Start and OrbStack will pull images and launch services with live logs.

If you prefer the command line, you can also:

# Run a container
orbstack run -d --name jellyfin jellyfin/jellyfin:latest

# List running containers
orbstack ps

# Stop a container
orbstack stop [container_name]

# View logs
orbstack logs [container_name]

Both the UI and CLI methods work; choose what fits your workflow.

---

Step 6: Manage Containers Easily

OrbStack’s UI makes day‑to‑day management easy: start or stop services, inspect logs, and open interactive shells without touching the terminal.

Keep these best practices in mind:

• Store containers and persistent directories under ~/server_data for consistency
• Back up ~/server_data/orbstack regularly
• Use Tailscale or a reverse proxy for secure external access without manual router port forwarding

---

Step 7: Make It Auto‑Start on Reboot

To ensure your server restarts after power outages or reboots, enable automatic login for your macOS user, set OrbStack to open at login, and make sure your containers use restart: unless-stopped in Compose. With that in place, your Mac mini will behave like a true appliance, booting up and bringing services online on its own.

---

Helpful Tips

• Use Docker Compose for multi‑container stacks to stay organized
• Snapshot OrbStack’s VM before making significant changes
• Check logs before modifying configurations
• Keep macOS updated for better network and VM performance

---

Final Thoughts

OrbStack makes container hosting on macOS easy, fast, reliable, and efficient. Now that you’ve got OrbStack up and running on your Mac mini, check out Best Use Cases for a Mac Home Server for ideas and recommendations on what to host on your home server.