brainrotguard
★ 401About
Community Ratings
No ratings yetNew this week
Read recap →Features
- Simple search
- Instant playback
- Video library
- Category browsing
- Channel browsing
- YouTube Shorts support
- Thumbnail previews
- Dark theme
- Telegram approval
- Channel allow/block lists
Details
- Last Updated
- Nov 14, 2026
- Created
- Feb 15, 2026
- Install Methods
- dockerdocker-composesource
- Requirements
- DockerTelegram accountTelegram bot tokenchat IDa computer that stays ondevice lockdown via Family Link or Screen Time
- Default Port
- 8080web UI
- Authentication
- local
- Backup & Export
- file-backup
- Privacy & Independence
- No TelemetryCloud: OptionalOffline Capable
- User Model
- Multi-User
- Theming
- Dark mode
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run brainrotguard yourself
Pick how much you want to manage.
netcupBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
1 more way to host
Some links earn us a commission. netcup pays us one and is our preferred VPS host.
Is this your project? Sponsor a listing
Run brainrotguard with Docker Compose
Compose file from the brainrotguard project repository.
1 service
no resource limits declared
needs persistent storage (2 volumes)
docker-compose.yml · @ 2165347 · scanned Nov 3, 2026
services:
brainrotguard:
build: .
image: brainrotguard
container_name: brainrotguard
restart: unless-stopped
ports:
- "8080:8080"
environment:
- BRG_BOT_TOKEN=${BRG_BOT_TOKEN}
- BRG_ADMIN_CHAT_ID=${BRG_ADMIN_CHAT_ID}
- BRG_TELEGRAM_API_URL=${BRG_TELEGRAM_API_URL:-}
- BRG_PIN=${BRG_PIN:-}
- BRG_BASE_URL=${BRG_BASE_URL:-}
volumes:
- ./config.yaml:/app/config.yaml:ro
- brg_db:/app/db
networks:
- brainrotguard
volumes:
brg_db:
networks:
brainrotguard:
driver: bridge
This file may be out of date. Check the brainrotguard documentation for current setup steps.
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.