Getting Started with Vidra
Vidra is a high-performance, PeerTube-compatible video platform built in Go. It provides video hosting, live streaming, federation, and P2P distribution out of the box.
Two Ways to Set Up
Vidra offers two setup paths depending on your needs:
| Method | Best For | Time |
|---|---|---|
| Setup Wizard | First-time users, Docker deployments, visual configuration | ~5 minutes |
| CLI Setup | Experienced admins, automation, custom infrastructure | ~10 minutes |
Prerequisites
Before you begin, make sure you have:
- Docker and Docker Compose (v2+) — for Docker deployments
- Go 1.24+ — for building from source
- PostgreSQL 13+ — if using an external database
- Redis 6+ — if using an external cache
- FFmpeg — for video transcoding
- At least 2 GB RAM (4 GB+ recommended for IPFS/ClamAV)
Quick Start (Docker)
The fastest way to get running:
git clone https://github.com/yosefgamble/athena.git vidra
cd vidra
docker compose up --build
Then open http://localhost:8080 in your browser. The setup wizard will launch automatically on first run.
What Gets Configured
Regardless of which setup method you choose, you'll configure:
- Database — PostgreSQL connection (Docker-managed or external)
- Cache — Redis for session and data caching
- Storage — Local filesystem, IPFS, or S3-compatible storage
- Email — SMTP for notifications, password resets, verification
- Networking — Domain, port, TLS/SSL configuration
- Security — JWT secret and administrator account
- Optional Services — IPFS, ClamAV virus scanning, Whisper captions, IOTA payments