Home
Softono
mediabox

mediabox

Open source MIT Shell
GitHub
438
Stars
82
Forks
10
Issues
26
Watchers
1 month
Last Commit
VPN & Firewalls

About mediabox

Container based media tools configuration

Platforms

Web Self-hosted Docker

Languages

Shell

Links

Source Code
t
Published by
tom472
Visit View Profile

README.md

View on GitHub

Mediabox

Mediabox is an all Docker Container based media aggregator stack.

Components include:

Prerequisites

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 :)

Donate

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.