nas-logo

Provision an Apple Silicon Mac Mini as an Immich NAS using Ansible roles.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/logo-solutions/NAS-logo --skill nas-logo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nas-logo
Source: https://github.com/logo-solutions/NAS-logo/tree/main/.claude/skills/nas-logo
Command: npx skills add https://github.com/logo-solutions/NAS-logo --skill nas-logo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides the complete project context and operational guidance to provision a Mac Mini into a reproducible personal photo NAS running Immich, automating installation, storage mounting, monitoring, backups, and security configuration with Ansible.

Core Features & Use Cases

  • Reproducible Provisioning: Encodes the bootstrap, preflight, dry-run, and install sequence using idempotent Ansible roles for Homebrew, Docker Desktop, Immich, PostgreSQL, Redis, and system dependencies.
  • Secure Backups & Networking: Documents rclone encrypted backups to Hetzner Storage Box and Tailscale VPN configuration to avoid exposing ports to the internet.
  • Monitoring & Alerts: Describes Prometheus, Grafana, cAdvisor, and ntfy integration for metrics, dashboards, and mobile alerts.
  • Use Case: Convert a fresh Apple Silicon macOS Mac Mini with an external SSD into a managed Immich photo server with scheduled encrypted backups and centralized monitoring.

Quick Start

Run the Ansible playbooks in order: bootstrap, preflight with a dry-run, then install to provision the Mac Mini according to the NAS-logo repository.

Frequently Asked Questions about nas-logo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Immich installation on a Mac Mini using Ansible?

Provisioning a Mac Mini NAS with Ansible involves running idempotent roles to mount external SSDs, install Docker Desktop, and configure Immich. You execute bootstrap, preflight, and install make targets to deploy the complete photo server environment.

What is needed to configure encrypted backups for an Immich server?

Configuring encrypted backups for an Immich server requires rclone integration to sync data to a Hetzner Storage Box. The Ansible playbook manages this setup alongside healthchecks to verify backup completion and ensure data safety.

Can I use Ansible to set up Prometheus and Grafana monitoring for a macOS NAS?

Yes, you can use Ansible to set up Prometheus and Grafana monitoring for a macOS NAS. The provisioning process integrates cAdvisor for metrics collection and ntfy for mobile alerts, providing comprehensive dashboards for your Immich environment.

Does this Ansible NAS provisioning support Apple Silicon macOS hosts?

Yes, this Ansible NAS provisioning explicitly supports Apple Silicon macOS hosts. It is designed to convert a fresh Mac Mini into a reproducible personal photo NAS, handling macOS-specific dependencies like Homebrew and Docker Desktop.

How do I manage secrets when provisioning a Mac Mini with Ansible?

Managing secrets when provisioning a Mac Mini with Ansible is handled through ansible-vault secret management. This ensures secure storage and deployment of sensitive information like database credentials and Tailscale VPN configurations.

What is the best way to secure an Immich server and avoid exposing ports to the internet?

The best way to secure an Immich server and avoid exposing ports to the internet is by configuring a Tailscale VPN. The Ansible provisioning process automates this Tailscale integration, ensuring your NAS environment remains private and protected.