Table of Contents
This project is not yet finished, it is missing scripts to automatically configure all services based on your .env file.
Pronunciation: /ɑːrˈkɪvʊm/
Archivum serves as a fully featured pirating media server, providing users with access to a vast collection of pirated media content. The primary aim is to offer an all-in-one solution for downloading, organizing, and streaming media such as movies, TV shows, and more.
- Automatic monitoring and downloading of new episodes/movies using Sonarr, Radarr and Deluge
- Organizing and renaming downloaded content into a consistent folder structure
- ⭐ Automated conversion of all downloaded movies and series to MP4 (Video: H.264 (AVC) / Audio: AAC) format for universal device compatibility using FFmpeg
- This means no more transcoding while streaming and native playback on all clients, limiting CPU load on the server
- ⭐ VPN protection for download clients using OpenVPN or WireGuard (through Gluetun) to protect privacy and bypass ISP throttling
- Plex media server for streaming to all devices
- ⭐ Reverse proxy and automated DNS updating using DDNS-Updater and Nginx-Proxy-Manager to access media remotely from a static domain name while still supporting a dynamic IP address
- Full overview of all running downloads, speeds and health status via the built-in web interfaces of Homarr
- Automated fallback to Deluge (torrents) when the usenet download fails in Radarr/Sonarr
- Full statistics monitoring of all Plex activity using Tautulli
- Dashboard to find series & movies and automatically add their download tasks to Sonarr/Radarr using Overseerr
- ⭐ Automated notifications of new downloads via Pushover
⭐: Indicates a core feature of Archivum which are otherwise often not present in similar projects
- acme.sh is a simple, powerful, and lightweight script to automatically issue and renew SSL certificates using ACME protocol.
- DDNS-Updater is a dynamic DNS updater with support for multiple DNS services. It allows you to update your IP address and create subdomains for your home or office network.
- Deluge is a lightweight, Free Software, cross-platform BitTorrent client. It is designed to run as both a normal standalone desktop application and as a client-server.
- FFMpeg is a comprehensive multimedia framework capable of decoding, encoding, transcoding, muxing, demuxing, streaming, filtering, and playing almost anything that humans and machines have created.
- Gluetun is a VPN client in a lightweight Docker container, it aims to be secure, fast, and reliable with all VPN providers.
- Homarr is a sleek and customizable dashboard for managing your web services. It provides a centralized interface to access all your web applications.
- Home Assistant is an open-source home automation platform that focuses on privacy and local control. It can control and automate various devices in your home.
- Jackett acts as a proxy server, allowing apps like Sonarr and Radarr to communicate with various torrent indexers and provide search results.
- nginx-proxy is a reverse proxy container that automatically configures itself for new containers and services using NGINX and Docker.
- nzbhydra2 is a meta search for NZB indexers that allows easy searching and managing of multiple NZB sources in one place.
- Overseerr is a request management and media discovery tool for your media server. It allows your shared Plex or Emby users to request new content easily.
- Plex is a media server that organizes your media library and streams it to any device. It provides a comprehensive solution for managing and accessing your media collection.
- Prowlarr is an indexer manager/proxy built on the popular Sonarr/Radarr applications. It integrates seamlessly with your existing media management software.
- Radarr is a movie collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new releases of your favorite movies and will grab, sort, and rename them.
- Sabnzbd is an Open Source Binary Newsreader written in Python. It simplifies the process of downloading from Usenet by automating the process of downloading, verifying, and extracting files.
- Sonarr is a PVR for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new episodes of your favorite shows and will grab, sort, and rename them.
- Tautulli is a monitoring and tracking tool for Plex Media Server. It provides detailed statistics and reports on your Plex usage and activity.
The following software is required, some of the services cost money (the usenet related services), the total yearly cost if you go for the full configuration (two usenet indexers and two usenet downloaders for optimal speed) is 177 USD / year (27 USD for indexers, 90 USD for downloaders). The minimal recommended configuration would cost 72 USD / year (1 indexer, 1 downloader), alternatively you can ignore all the usenet stuff and run completely for free by only using deluge / torrents, although this will diminish the ease of access to content.
| Landlubber (aka non-pirate way) | Archivum (Full) | Archivum (Frugal) | Archivum (Free) |
|---|---|---|---|
| Netflix (Standard): €161.88/year | Indexers (2): $27/year | Indexer (1): $12/year | Deluge/Torrents: Free |
| Amazon Prime: €49/year | Downloaders (2): $90/year | Downloader (1): $60/year | Deluge/Torrents: Free |
| Disney+: €89.90/year | |||
| Apple TV+: €83.88/year | |||
| HBO Max: €120/year | |||
| Streamz: €143.40/year | |||
| TOTAL: €648.06/year | TOTAL: $177/year | TOTAL: $72/year | TOTAL: Free |
We recommend "Archivum (Frugal)" method as the minimum to enjoy all usenet benefits while keeping costs low. The prices for Archivum are based on my personal selected indexers and downloaders, you can find cheaper alternatives although always keep in mind that they might provide less content coverage or slower speeds.
This guide is writen with a Debian (eg. WSL2) or MacOS environment in mind, we do NOT recommend doing dev work on a plain old Windows OS.
- (If windows) WSL2 (instructions)
- HIGHLY RECOMMENDED if using Windows as a host
- Docker Engine (instructions)
- If using a Windows host, running Docker Desktop on the host is sufficient (it will hook automatically into your WSL2 instance if configured as such in Docker Desktop (which is default config))
- Direnv (instructions)
- Once installed, run
direnv allowin root folder
- Once installed, run
- Make (website)
- Accounts / Credentials:
cp .env.example .env- Edit the
.envfile in the root folder - (WIP INSTRUCTIONS)
AUTOCONFIG SCRIPT WIP
With the current configuration, Archivum will write the completed content to a local volume in this repository folder, however, ideally you want to write your completed content to a local NAS or a mounted external drive for increased storage capacity and ease of access. You can do this without much hassle by doing the following, you can use either one of the following options to achieve the same result:
- Make sure you have the path to the mounted volume (eg.
/mnt/c) - Make a symbolic link to your mounted volume (and/or subfolder(s))
- (root folder)
ln -s <TARGET> storage/downloads/complete
- (root folder)
- Make sure you have two folders in that location -
moviesandseries
- Look at the example in docker-compose.yaml file, at the bottom, "hetzner_storage_share", this is a mounted network drive from Hetzner Robot
To obfuscate the purpose of this media server a little bit, we've chosen to deviate from the default ports used by these services. Only the plex container is exposed to the host machine (and due to the network being bridge, the world wide web), all other machines are only accessible through the nginx reverse proxy.
Here are the port mappings being used:
- sabnzbd
- Configured port: 38080 (default is 8080)
- deluge
- Configured port: 38081 (default is 8112)
- Configured port: 6881:6881/udp (default is 58846)
- sonarr
- Configured port: 38082 (default is 8989)
- radarr
- Configured port: 38083 (default is 7878)
- prowlarr
- Configured port: 38084 (default is 9696)
- overseerr
- Configured port: 38085 (default is 5055)
- plex
- Configured port: unchanged (default is 32400)
- heimdall
- Configured port: unchanged (default is 80/443)
- tautulli
- Configured port: 38086
- nzbhydra2
- Configured port: 38087
- jackett
- Configured port: 38088
Without changing any configuration files, you only need to forward port 80 and port 443 on your router to access services over the internet. If you don't plan to ever access the media server remotely, we recommend keeping these ports closed. We are forcing HTTPS connections so the 80 port is purely to catch unprotected requests and forward them to 443.
-
Start the composed containers (without VPN layer):
make up
-
Stop the composed containers (without VPN layer):
make down
-
Start the composed containers (with VPN layer):
make up.vpn
-
Stop the composed containers (with VPN layer):
make down.vpn
-
Enforce correct file system permissions:
make perm
-
Mount the 'D'-drive from Windows host to your WSL2 instance: (change the drive letter as needed here)
make mount
-
Generate a strong hashing password and print into console:
make hash.strong
-
Generate a random, human readable password:
make hash.human