No description
Find a file
Michael Murphy dda11d57e5
Fixed link for YouTubeDL-Material
- the YouTubeDL-Material was linking to the [youtube-dl](https://ytdl-org.github.io/youtube-dl) project.
- modified text on Krusader link
2020-05-17 13:17:25 +02:00
.github Create application_request.md 2020-01-16 22:33:14 +00:00
.vscode Update vscode tasks to include mkdocs 2018-12-26 11:56:57 +00:00
docs Fix Mylar merge conflicts 2020-05-13 00:13:02 +01:00
files Lots of work on stats, including an awesome Ansible-NAS Grafana dashboard 2020-04-20 00:14:33 +01:00
group_vars Add mylar_enabled var 2020-05-13 00:14:19 +01:00
inventories/sample Rejig config/yml structure 2020-01-08 16:12:03 +00:00
misc Add logo 2018-12-24 13:43:37 +00:00
tasks Fix Mylar merge conflicts 2020-05-13 00:13:02 +01:00
templates Fix Mylar merge conflicts 2020-05-13 00:13:02 +01:00
tests Update test-vagrant.sh 2020-01-09 06:53:47 -06:00
.gitattributes Add .gitattributes 2018-12-23 22:17:14 +00:00
.gitignore Update gitignore 2019-07-04 00:28:57 +01:00
.travis.yml Fix broken travis build 2020-01-06 11:39:54 +00:00
ansible.cfg Initial Ansible NAS commit 2017-08-28 16:31:54 +01:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2020-01-09 17:02:24 +00:00
CONTRIBUTING.md Typo fix in CONTRIBUTING.md 2020-04-25 23:24:02 +01:00
LICENSE Update LICENSE to include 2020 2020-04-25 15:09:39 -07:00
mkdocs.yml Fix mkdocs.yml for mkdocs-material v5 2020-04-20 00:32:33 +01:00
nas.yml Fix Mylar merge conflicts 2020-05-13 00:13:02 +01:00
permission_data.yml Update the account samba uses to serve to guests, and permission share directories accordingly 2018-12-28 13:07:40 +00:00
README.md Fixed link for YouTubeDL-Material 2020-05-17 13:17:25 +02:00
requirements.yml Update role requirements to latest versions 2020-04-24 23:32:47 -07:00
Vagrantfile Require at least Vagrant 2.2.2 2018-12-28 13:00:32 +00:00

Ansible NAS

Build Status Gitter chat license Ko-fi

After getting burned by broken FreeNAS updates one too many times, I figured I could do a much better job myself using just a stock Ubuntu install, some clever Ansible config and a bunch of Docker containers.

What Ansible-NAS Can Set Up

  • An awesome dashboard to your home server (Heimdall)
  • Any number of Samba shares or NFS exports for you to store your stuff
  • A BitTorrent client
  • A Usenet downloader
  • Various media management tools - Sonarr, Sickchill, CouchPotato, Radarr, Bazarr, Lidarr
  • Media streaming via Plex or Emby
  • Music streaming with Airsonic
  • An RSS newsfeed reader - Miniflux
  • A Dropbox replacement via Nextcloud
  • Various ways to see stats about your NAS - Glances, dashboards in Grafana
  • A backup tool - allows scheduled backups to Amazon S3, OneDrive, Dropbox etc
  • An IRC bouncer and web-based client
  • Source control with Gitea
  • SSL secured external access to applications via Traefik
  • A Docker host with Portainer for image and container management
  • An automatic dynamic DNS updater if you use Cloudflare to host your domain DNS
  • A Personal finance manager
  • eBook management with calibre-web
  • Content management with Joomla
  • A dual panel local file manager
  • Self-service media request web application
  • SEO tracking with Serposcope

Available Applications

  • Airsonic - catalog and stream music
  • Bazarr - companion to Radarr and Sonarr for downloading subtitles
  • Bitwarden_rs - Self-Hosting port of password manager
  • Calibre - eBook Library
  • Cloud Commander - A dual panel file manager with integrated web console and text editor
  • Cloudflare DDNS - automatically update Cloudflare with your IP address
  • CouchPotato - for downloading and managing movies
  • Duplicati - for backing up your stuff
  • Emby - Media streaming and management
  • Firefly III - Free and open source personal finance manager
  • get_iplayer - download programmes from BBC iplayer
  • Gitea - Simple self-hosted Github clone
  • Gitlab - Self-hosted Github clone of the highest order
  • Glances - for seeing the state of your system via a web browser
  • Grafana - Dashboarding tool
  • Guacamole - Web based remote desktop gateway, supports VNC, RDP and SSH
  • Heimdall - Home server dashboard
  • Home Assistant - Open source home automation
  • InfluxDB - Time series database used for stats collection
  • Jackett - API Support for your favorite torrent trackers
  • Jellyfin - The Free Software Media System
  • Joomla - Open source content management system
  • Krusader - Twin panel file management for your desktop
  • Lidarr - Music collection manager for Usenet and BitTorrent users
  • MiniDlna - simple media server which is fully compliant with DLNA/UPnP-AV clients
  • Miniflux - An RSS news reader
  • Mosquitto - An open source MQTT broker
  • Mylar - An automated Comic Book downloader (cbr/cbz) for use with SABnzbd, NZBGet and torrents
  • MyMediaForAlexa - Lets you stream your music collection to your alexa device
  • Netdata - An extremely comprehensive system monitoring solution
  • Nextcloud - A self-hosted Dropbox alternative
  • NZBget - The most efficient usenet downloader
  • Ombi - web application that automatically gives your users the ability to request content
  • Organizr - ORGANIZR aims to be your one stop shop for your Servers Frontend.
  • openHAB - A vendor and technology agnostic open source automation software for your home
  • Plex - Plex Media Server
  • Portainer - for managing Docker and running custom images
  • pyLoad - A download manager with a friendly web-interface
  • PyTivo - An HMO and GoBack server for TiVos.
  • Radarr - for organising and downloading movies
  • Serposcope - tracker to monitor website ranking
  • Sickchill - for managing TV episodes
  • Sonarr - for downloading and managing TV episodes
  • Tautulli - Monitor Your Plex Media Server
  • Telegraf - Metrics collection agent
  • The Lounge - Web based always-on IRC client
  • TimeMachine - Samba-based mac backup server
  • Traefik - Web proxy and SSL certificate manager
  • Transmission - BitTorrent client (with OpenVPN if you have a supported VPN provider)
  • Ubooquity - Book and comic server
  • uTorrent - The best torrent downloading app for beginners
  • Virtual Desktop - A virtual desktop running on your NAS.
  • Wallabag - Save and classify articles. Read them later.
  • Watchtower - Monitor your Docker containers and update them if a new version is available
  • YouTubeDL-Material - Self-hosted YouTube downloader built on Material Design
  • ZNC - IRC bouncer to stay connected to favourite IRC networks and channels

What This Could Do

Ansible-NAS can run anything that's in a Docker image, which is why Portainer is included. A NAS configuration is a pretty personal thing based on what you download, what media you view, how many photos you take...so it's difficult to please everyone.

That said, if specific functionality you want isn't included and you think others could benefit, add it and raise a PR!

What This Doesn't Do

Ansible NAS doesn't set up your disk partitions, primarily because getting it wrong can be incredibly destructive. That aside, configuring partitions is usually a one-time (or very infrequent) event, so there's not much to be gained by automating it. Check out the docs for recommended setups.

Installation

See Installation.

Upgrading

The way Ansible-NAS configuration is structured has changed! See Upgrading for more information. See the Getting Help section if you get stuck.

Documentation

You can read the docs here. PRs for more documentation always welcome!

Migrating from FreeNAS

Assuming that your Ubuntu system disk is separate from your storage (it should be!):

  1. Ensure you have a working backup of your data.
  2. Check that the working backup you think you have actually works.
  3. SSH to the server and run zpool list to determine available ZFS pools.
  4. zpool import <pool_name> against each of the pools you want to attach.
  5. chown -R root:root /mnt/<pool_name> to fix the ownership of the data.
  6. Follow the Quick Start instructions above.

Requirements

  • Ansible NAS targets the latest Ubuntu LTS release, which is currently Ubuntu Server 18.04.3 LTS.
  • You can run Ansible-NAS on whatever you like, read the docs for more info. I use an HP Microserver.

Getting Help

Getting help is easy! You can:

Contributing

Contributions are always welcome! Please read CONTRIBUTING.md first.

Support

If you've enjoyed Ansible-NAS as much as I do working on it, please consider buying me a coffee

Thanks

Thanks to the awesome dudes at JetBrains for supplying core contributors with JetBrains Open Source licenses!