Ansible NAS
Automate your home NAS setup with Ansible and Docker containers. Provision a full-featured NAS with media, backups, and self-hosted apps in minutes.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Turn Ubuntu into a full NAS with Ansible and Docker containers, code-controlled and break-free.
Core Features
- One-command automation: provision a full NAS from stock Ubuntu using Ansible and Docker
- Rich app catalog: 100+ self-hosted apps including Plex, Nextcloud, Home Assistant, Jellyfin, Bitwarden
- Infrastructure as Code: all configurations in Ansible playbooks, version-controllable and reproducible
- External access ready: domain name support with automatic DNS updates for remote access
- Compared to TrueNAS/FreeNAS: lighter, more flexible, no vendor lock-in, fully customizable
What It Can't Do
- •Only Ubuntu 20.04/22.04 LTS is officially supported; other distros require manual tweaks,Requires basic knowledge of Ansible and Linux; not a beginner-friendly click-and-install tool,Some apps (e.g., GitLab) need significant RAM; at least 4GB is recommended,Automatic DNS updates rely on Cloudflare or similar providers; you need a domain and API token ready,First deployment may take a while if you enable many apps (depends on network and hardware)
Use Cases
- Set up a complete home server with media streaming, cloud storage, password manager, smart home hub, and more
- Replace FreeNAS/TrueNAS with a more controllable, easily maintainable NAS system
- Quickly provision self-hosted tools like CI/CD, Git repos, and monitoring for dev/test environments
Ansible NAS is an Ansible-based deployment tool that transforms a fresh Ubuntu server into a full-featured Network Attached Storage (NAS) and self-hosted application platform. It automates the installation and configuration of dozens of popular applications—like Plex, Nextcloud, Home Assistant, Jellyfin, and many more—using Docker containers. You get a consistent, reproducible, and easily maintainable setup that can be updated or extended through simple playbook changes. Unlike proprietary NAS solutions, Ansible NAS gives you full control over every component, and because it's just a stock Ubuntu install with containers, you avoid the breakage that can come from upstream vendor updates. The project supports external domain access, automatic DNS updates, and integrates with tools like Traefik for reverse proxy. It's ideal for homelab enthusiasts who want a declarative, infrastructure-as-code approach to their home server.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Install Ansible on your Ubuntu 22.04+ server (sudo apt install ansible)
Step 2: Clone the Ansible NAS repo: git clone https://github.com/davestephens/ansible-nas.git && cd ansible-nas
Step 3: Copy config template: cp nas.yml.example nas.yml, then edit nas.yml to enable desired apps and settings
- Step 1: Install Ansible on your Ubuntu 22.04+ server (sudo apt install ansible)
- Step 2: Clone the Ansible NAS repo: git clone https://github.com/davestephens/ansible-nas.git && cd ansible-nas
- Step 3: Copy config template: cp nas.yml.example nas.yml, then edit nas.yml to enable desired apps and settings
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Because all services run in Docker containers, uninstalling is straightforward: stop and remove all containers and images: docker stop $(docker ps -aq) && docker rm $(docker ps -aq) && docker system prune -a. For a clean slate, reinstall Ubuntu.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
3 FAQs
Similar Projects
Huginn
Huginn lets you build agents that automate online tasks. Events propagate through a directed graph. Monitor web, Twitter, email, and more.
RSSHub
RSSHub is the world's largest open-source RSS network. It generates RSS feeds from virtually any website, with over 5,000 instances and a thriving community. Perfect for aggregating social media, news, blogs, and more.
Puter
An open-source internet computer that lets you access all your files, apps, and games from anywhere, with self-hosting for full control.