Mediabox

Mediabox is an all Docker Container based media aggregator stack.

Components include:

• Bazarr subtitle manager
• Couchpotato movie library manager
• Deluge torrent client (using VPN)
• Dozzle realtime log viewer
• Duplicati Backup Software
• Emby Open Media Solution
• Filebrowser Web-Based File Manager
• Flaresolverr proxy server to bypass Cloudflare protection (Used with Jackett)
• Glances system monitoring
• Headphones automated music downloader
• Homer - Server Home Page
• Homer Icons - Icons for Homer
• Jackett Tracker API and Proxy
• Jellyfin Free Software Media System
• Lidarr Music collection manager
• Maintainerr library management system
• MeTube Web GUI for youtube-dl
• Minio cloud storage
• NetData System Monitoring
• NZBGet Usenet Downloader
• NZBHydra2 Meta Search
• Ombi media assistant
• Seerr Media Library Request Management
• Plex media server
• Portainer Docker Container manager
• Prowlarr indexer manager/proxy
• Radarr movie library manager
• Requestrr Chatbot for Sonarr/Radarr/Ombi
• SABnzbd Usenet download tool
• SickChill TV library manager
• Sonarr TV library manager
• Speedtest - Tracker
• SQLitebrowser DB browser for SQLite
• Tautulli Plex Media Server monitor
• Tdarr Distributed Transcoding System
• TubeSync - YouTube PVR
• Watchtower Automatic container updater

Prerequisites

• Ubuntu 24.04 LTS
• VPN account from Private internet Access (Please see binhex's Github Repo if you want to use a different VPN)
• Git
• Docker
• Docker-Compose

PLEASE NOTE

For simplicity's sake (eg. automatic dependency management), the method used to install these packages is Ubuntu's default package manager, APT. There are several other methods that work just as well, if not better (especially if you don't have superuser access on your system), so use whichever method you prefer. Continue when you've successfully installed all packages listed.

Installation

(You'll need superuser access to run these commands successfully)

Installation (Ubuntu 24.04.3 LTS)

1) Update and upgrade packages

sudo apt update && sudo apt full-upgrade

2) Install prerequisites

sudo apt install -y curl git bridge-utils whiptail

3) Remove old Docker (OK if nothing to remove)

sudo apt remove -y docker docker-engine docker.io containerd runc
sudo snap remove docker

4) Install Docker CE (official method)

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verify:

docker --version
docker compose version

5) Add your user to the docker group

sudo usermod -aG docker $USER
newgrp docker

6) DelugeVPN kernel module

sudo /sbin/modprobe iptable_mangle
echo iptable_mangle | sudo tee -a /etc/modules

7) Reboot (recommended if Docker group just added)

sudo reboot

Using mediabox

Once the prerequisites are all taken care of you can move forward with using mediabox.

8) Clone Mediabox

git clone https://github.com/jamesvthompson/mediabox.git
cd mediabox

9) Configure & Deploy

# Run the Mediabox setup script (collects .env and prepares compose)
./mediabox.sh

Notes

• Plex tag: set PMSTAG in .env (e.g., public or plexpass). Example image: image: plexinc/pms-docker:${PMSTAG:-public}
• If you change image tags, test them directly first:

Using mediabox

Please be prepared to supply the following details after you run Step 3 above

As the script runs you will be prompted for:

1. Your Private Internet Access credentials

   • username
   • password

2. The version of Plex you want to run

   • latest
   • public
   • plexpass

   Note: If you choose plexpass as your version you may optionally specify CLAIM_TOKEN - you can get your claim token by logging in at plex.tv/claim

3. Credentials for the NBZGet interface and the Deluge daemon which needed for the CouchPotato container.

   • username
   • password

Upon completion, the script will launch your mediabox containers.

Portainer has been switched to the CE branch

• A Password will now be required - the password can be set at initial login to Portiner.
• Initial Username The initial username for Portainer is admin

Mediabox has been tested to work on Ubuntu 18.04 LTS / 20.04 LTS - Server and Desktop

Thanks go out to:

@kspillane

@mnkhouri

@danipolo

binhex

LinuxServer.io

Docker

Portainer.io

---

If you enjoy the project -- Fuel it with some caffeine :)

---

Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License

MIT License

Copyright (c) 2017 Tom Morgan

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.