Introduction to Self-Hosting with Tube Archivist
If you’re looking to take control of your online video collection, self-hosting Tube Archivist is a powerful solution. It allows you to index and manage your YouTube videos offline, providing a seamless experience with enhanced privacy. This guide walks you through the steps necessary to set up Tube Archivist using Docker containers, ensuring you can enjoy your favorite content without the hassle of online searches. Let’s dive in!
Understanding Tube Archivist
Tube Archivist is an open-source tool that helps you manage and archive your YouTube video collection. According to its GitHub page, what sets it apart is its ability to:
- Index videos with YouTube metadata
- Subscribe to channels and download videos using yt-dlp
- Search and organize archived content easily
- Track which videos you’ve watched
Setting Up Tube Archivist on Your NAS
This guide focuses on installing Tube Archivist using Docker’s Projects feature, which simplifies the setup process compared to manual configuration. Before you start, ensure that you have followed the initial setup in previous guides.
Creating the Necessary Folders
Begin by organizing your directory structure. Open File Station and create the following folders:
- /data/media/youtube
- /docker/projects/archivist-compose
- /docker/tubearchivist/cache
- /docker/tubearchivist/redis
- /docker/tubearchivist/es
Setting Folder Permissions
Next, to avoid permission issues with the Redis and Elasticsearch containers, you need to adjust the folder permissions via SSH. Enter the following commands:
sudo chown 1000:0 /volume1/docker/tubearchivist/es
sudo chown 999:100 /volume1/docker/tubearchivist/redis
No output confirms that the commands were executed successfully.
Configuring Container Manager
Open Container Manager and click on Project, then select Create. Fill in the General Settings, making sure to set the project name and path correctly:
- Project Name: tubearchivist
- Path: /docker/projects/archivist-compose
- Source: Create docker-compose.yml
Inserting Docker Compose Configuration
Next, drop your Docker Compose configuration into the designated area:
version: '3'
services:
tubearchivist:
container_name: tubearchivist
image: bbilly1/tubearchivist
ports:
- 8000:8000/tcp
volumes:
- /volume1/data/media/youtube:/youtube
- /volume1/docker/tubearchivist/cache:/cache
environment:
- ES_URL=
- REDIS_CON=redis://archivist-redis:6379
- HOST_UID=1234 #CHANGE_TO_YOUR_UID
- HOST_GID=65432 #CHANGE_TO_YOUR_GID
- TA_HOST=192.168.0.10:8000 #Change to your NAS IP
- TA_USERNAME=enter-a-username
- TA_PASSWORD=enter-a-password
- ELASTIC_PASSWORD=enter-a-password
- TZ=Europe/London #CHANGE_TO_YOUR_TZ
depends_on:
- archivist-es
- archivist-redis
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/api/health"]
interval: 2m
timeout: 10s
retries: 3
start_period: 30s
security_opt:
- no-new-privileges:true
restart: always
Fine-Tuning Environment Variables
To ensure that the containers function correctly, adjust the following environment variables:
- HOST_UID: Your specified UID
- HOST_GID: Your specified GID
- TA_HOST: Your NAS IP Address
- TA_USERNAME: Username for login
- TA_PASSWORD: Password for login
- ELASTIC_PASSWORD: Password for the Elasticsearch container
- TZ: Your time zone
Finalizing the Setup
Once your configuration is complete, click Next through the subsequent screens, ensuring no additional settings are activated. Click Done to initiate the container download and launch. The first startup may take a few minutes. Be patient while it initializes.
Accessing Tube Archivist
Upon successful startup, Tube Archivist will be accessible at http://192.168.0.40:8000
. Log in with the details you set up earlier. You can explore UI features, including:
- Channels: Add URLs for channels you wish to subscribe to.
- Downloads: Grab individual videos as needed.
Conclusion
If you want an organized way to manage your media, Tube Archivist is a fantastic self-hosting option. Its ability to give you control over your video collection not only enhances your viewing experience but also safeguards your privacy. Remember to check the Tube Archivist documentation for additional features and the latest updates.
FAQ
Question 1: Can I run Tube Archivist on a virtual server?
Answer 1: Yes, Tube Archivist works effectively on both physical and virtual servers that support Docker.
Question 2: Is Tube Archivist suitable for large video collections?
Answer 2: Absolutely! Tube Archivist is designed to manage extensive collections efficiently.
Question 3: What support is available for Tube Archivist users?
Answer 3: You can join the Tube Archivist Discord community for assistance and tips from other users.