htpc-ansible

HTPC Server Automation with Kodi, Bittorent (Deluge), Usenet Software (sabnzbdplus), Couchpotato, Sickbeard, Tvheadend and nzbToMedia.

Overview

This ansible playbook is designed to quickly deploy home HTPC server, which can perform variety of funcitons. It's based on an Ubuntu 14.04, and can set up several configuration variants. It includes roles, which can be set up on a single machine, or on a different ones, and can be customized through single configuration file, correctly deploying all the software.

• Kodi - Open Source Home Theatre Software, with optional mysql backend support (can be used to manage single library for multiple Kodi clients at home)
• NAS configuration with support for sharing the library over NFS and CIFS
• HTPC Manager - combines all your favorite software into one slick interface
• Couchpotato - Download movies automatically
• Sick Beard - Internet PVR for your TV Shows
• SABnzbd - NZB capable binary newsgrabber
• Deluge - Cross-platform BitTorrent client
• nzbToMedia - postprocessing for CouchPotatoServer and SickBeard and etc.
• Tvheadend - TV streaming server for Linux

Prerequisites

1. Machine designated for an HTPC with Ubuntu 14.04 Desktop installed.
2. Correctly working name resolution on home network or "Static IP" configured on Ubuntu.

Quick installation

Login to your Ubuntu 14.04 machine using gui or console.

Open terminal and run:

wget --no-check-certificate https://raw.github.com/mholtrlc/htpc-ansible/master/scripts/quickinstall.sh -O - | sh

Choose roles/software and configure variables:

Warning: Don't enable Sabnzbd if you don't have usenet server credentials. ( When sabnzbd enabled, usenet will be used as a default search source in couchpotato and sickbeard )

 >> Run Wizard
Install Kodi ? [Y/n]:
Install Kodi Mysql Backend? [Y/n]:
Install NAS services ? [Y/n]:
Install Deluge [Y/n]:
Install Sabnzbd [y/N]:
Install Sickbeard [Y/n]:
Install Couchpotato [Y/n]:
Install HTPC-Manager [Y/n]:
Install TVheadend [y/N]:
Media path [/mnt/media]:
Movies Folder [movies]:
TV Folder [tv]:
Music Folder [music]:
Pictures Folder [pictures]:
HTPC User [kodi]:
HTPC User password [kodi]:

Reboot your machine following the installation.

Customizing the setup

Install Ansible and Git

sudo apt-get install software-properties-common
sudo apt-add-repository -y ppa:ansible/ansible
sudo apt-get update
sudo apt-get -y install ansible git

Clone the repository

git clone https://github.com/GR360RY/htpc-ansible.git
cd htpc-ansible

Edit Configuration

Create/Open custom.yml in your favorite editor and add/update variables. Most commonly changed variables are available in the defaults.yml file. All variables with detailed desription are located in each role README.md file:

Run Ansible Playbook from your localhost:

ansible-playbook -i hosts -c local -K htpc-server.yml

Role Tasks and Variables

The below list summarises tasks that will be performed in each role. Default variable values are appear in parentheses.

• kodi-client (README.md)

  • Install sshd service for remote access.
  • Create HTPC Linux User (kodi/kodi)
  • Create movies, tv, music, pictures and downloads folders under "Media Path" (/mnt/media)
  • Install latest Kodi version.
  • Configure HTPC user to autologin automatically and start Kodi software.
  • Enable Web Access to Kodi (username: xbmc and no password)

• kodi-mysql (README.md)

  • Install Mysql Server
  • Create Initial Databases for Videos and Music

• htpc-nas (README.md)

  • Share "Media Path" (/mnt/media) over NFS
  • Share "Media Path" (/mnt/media) over CIFS to allow access from Windows Machines

• deluge (README.md)

  • Install Deluge Daemon and configure to listen on port 8112
  • Install Deluge-Web Daemon and configure to listen on port 58846 ( default password deluge)
  • Create deluge downloads folders under "Media Path" ( /mnt/media/downloads/incomplete/deluged and /mnt/media/downloads/incomplete/process)
  • Create localclient user and identified by 2b9cf85259f2149da47458eda73ba23ac06faa21

• sabnzbd (README.md)

  • Install Sabnzbdplus and configure to listen on port 9000 ( Port number conflict with htpc-manager. Default port changed from 8080 )
  • Create sabnzbd incomplete downloads folder under "Media Path" ( /mnt/media/downloads/incomplete/sabnzbd)
  • Configure API Key for allowing access from htpc-manager, couchpotato and sickbeard (c48afc846972e295826bb05d2e84dd59)

• sickbeard (README.md)

  • Install Sickbeard

• couchpotato (README.md)

  • Install Couchpotato

• htpc-manager(README.md)

  • Install htpc-manager
  • Setup apache as reverse proxy to allow access to htpc-manager on port 80.

• tvheadend(README.md)

  • Install Tvheadend

Development and Testing with Vagrant

If you want to test out the configuration in VirtualMachine or contribute to htpc-ansible development, install requirements and follow the below guide:

Requirements

• Install Vagrant
• Install Oracle VirtualBox
• Install Snapshot plugin for Vagrant
• Install Ansible

Deployment

• Bring up ubuntu desktop only

vagrant up --no-provision

• Snapshot the machine.

vagrant snap take

• Deploying htpc-ansible

vagrant provision

• Reverting snapshot

In case you want to redeploy from scratch - simply revert the snapshot back to the machine with desktop installed.

vagrant snap rollback

Testing and configuring WEB services

Vagrant box is configured to have bridged eth1 interface. All the web services can be tested and configured through http://htpc-vm/