yams (original) (raw)

2026-03-23 23:10:55 -03:00

2023-11-12 10:39:21 -03:00

2026-03-23 23:10:55 -03:00

2023-10-30 14:49:54 -03:00

2024-09-23 11:48:31 +00:00

2025-11-08 09:20:04 +05:30

2026-01-26 09:09:33 -03:00

2024-01-12 14:57:37 +01:00

2025-09-02 18🔞37 -03:00

2026-01-31 10:56:20 -03:00

2025-03-19 16:10:15 -03:00

2026-01-24 18:29:24 -03:00

2026-03-23 23:10:55 -03:00

YAMS: Yet Another Media Server

visitor badge Discord

This is a highly opinionated media server that simplifies the setup and management of your home media collection.

Description

YAMS installs and configures a complete media server stack using Docker containers:

Download Management:

Media Management:

Media Servers (Choose One):

Management & Monitoring:

Features

YAMS provides a comprehensive media server solution with:

Dependencies

Required:

The installation script can automatically install these on Debian/Ubuntu systems.

Before Installation

Prepare the following:

  1. Installation Location
    • Default: /opt/yams
    • Ensure your user has write permissions
  2. Media Directory
    • Default: /srv/media
    • Will contain subdirectories:
      * /srv/media/tvshows: TV series
      * /srv/media/movies: Movies
      * /srv/media/music: Music files
      * /srv/media/books: Books and audiobooks
      * /srv/media/downloads: Temporary download location
      * /srv/media/blackhole: Watch folder for torrents
  3. Non-root User
    • Regular system user to own and manage files
    • Must have sudo privileges for initial setup
  4. VPN Service (Optional but Recommended)

Installation

Quick installation:

git clone --depth=1 https://gitlab.com/rogs/yams.git /tmp/yams
cd /tmp/yams
bash install.sh

Follow the interactive prompts to configure your installation.

Tested on:

Usage

YAMS provides a simple CLI interface:

yams - Yet Another Media Server

Usage: yams [command] [options]

Commands:
--help                    displays this help message
restart                   restarts yams services
stop                      stops all yams services
start                     starts yams services
status                    checks yams services status
destroy                   destroy yams services so you can start from scratch
check-vpn                 checks if the VPN is working as expected
backup                    backs up yams to the destination location
update-containers         updates all yams containers

Examples:
  yams start                   # Start all YAMS services
  yams backup /path/to/backup  # Backup YAMS to specified directory
  yams update-containers       # Update all containers

Configuration

Complete configuration guide: https://yams.media/config/

Future Development

Planned features and improvements:

Donations

If you'd like to support YAMS, please consider donating to the underlying projects:

YAMS Donations: The Very Last Priority 🏆

Okay, so you REALLY want to support YAMS? First, thank you! But honestly, I'm not doing this for money. YAMS is a passion project I created for myself and my friends. If you've already supported the projects above and still want to chip in, here are some options:

Donation Methods 💸

Special Thanks

YAMS wouldn't be possible without:

And most importantly: Thank you for using YAMS! 🙏

Contributors