Skip to content
Klutch.sh Docs

Deploying Reiverr

Introduction

Reiverr is a modern, unified interface for browsing and requesting media content. It integrates with popular media server and automation tools like Jellyfin, Plex, Radarr, and Sonarr to provide a seamless experience for discovering, requesting, and managing your media library. Built with SvelteKit, Reiverr offers a beautiful, responsive interface that works across all devices.

Key highlights of Reiverr:

  • Unified Interface: Single dashboard for content discovery across multiple services
  • Media Server Integration: Native support for Jellyfin and Plex media servers
  • Request Management: Integrated with Radarr and Sonarr for media requests
  • TMDB Integration: Rich metadata and content discovery from The Movie Database
  • Modern Design: Beautiful, responsive SvelteKit-based interface
  • Multi-User Support: User authentication and personalized experiences
  • Real-Time Updates: Live status updates for downloads and media availability
  • Mobile Friendly: Responsive design that works on any device
  • Open Source: Fully open-source under MIT license

This guide walks through deploying Reiverr on Klutch.sh using Docker, connecting it to your media stack, and configuring user access.

Why Deploy Reiverr on Klutch.sh

Deploying Reiverr on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh automatically detects your Dockerfile and builds Reiverr without complex configuration. Push to GitHub, and your media interface deploys automatically.

Persistent Storage: Attach persistent volumes for configuration data and user preferences that survive container restarts.

HTTPS by Default: Klutch.sh provides automatic SSL certificates for secure remote access to your media interface.

Always-On Availability: Your Reiverr instance remains accessible 24/7 for browsing and requesting content from anywhere.

Environment Variable Management: Securely store API keys and connection strings through Klutch.sh’s environment variable system.

Prerequisites

Before deploying Reiverr on Klutch.sh, ensure you have:

Preparing Your Repository

Create a GitHub repository containing your Dockerfile for Reiverr deployment.

Repository Structure

reiverr-deploy/
├── Dockerfile
└── .dockerignore

Creating the Dockerfile

Create a Dockerfile in the root of your repository:

FROM ghcr.io/aleksilassila/reiverr:latest


# Set environment variables
ENV ORIGIN=${ORIGIN}


# Create config directory
RUN mkdir -p /config


# Expose the web interface port
EXPOSE 9494


# The base image includes the default entrypoint

Environment Variables Reference

VariableRequiredDescription
ORIGINYesThe public URL of your Reiverr instance (e.g., https://your-app.klutch.sh)

Deploying Reiverr on Klutch.sh

    Push Your Repository to GitHub

    Commit and push your Dockerfile to GitHub.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project with a descriptive name like “reiverr” or “media-hub”.

    Create a New App

    Within your project, create a new app. Connect your GitHub account and select the repository containing your Reiverr Dockerfile.

    Configure HTTP Traffic

    In the deployment settings:

    • Select HTTP as the traffic type
    • Set the internal port to 9494

    Set Environment Variables

    Add the following environment variables:

    VariableValue
    ORIGINhttps://your-app-name.klutch.sh

    Attach Persistent Volumes

    Add the following volume:

    Mount PathRecommended SizePurpose
    /config1 GBConfiguration data and database

    Deploy Your Application

    Click Deploy to start the build process. Klutch.sh will build the container, attach volumes, and provision HTTPS.

    Access Reiverr

    Once deployment completes, access your Reiverr instance at your app URL.

Initial Configuration

First-Time Setup

After accessing Reiverr for the first time:

  1. Create your admin account
  2. Navigate to Settings to configure integrations

Connecting Services

Configure your media stack integrations:

  1. TMDB: Add your TMDB API key for content discovery
  2. Jellyfin/Plex: Add your media server URL and API key
  3. Radarr: Configure Radarr URL and API key for movie requests
  4. Sonarr: Configure Sonarr URL and API key for TV show requests

User Management

  1. Create additional user accounts as needed
  2. Configure user permissions and request limits
  3. Set up authentication preferences

Additional Resources

Conclusion

Deploying Reiverr on Klutch.sh gives you a beautiful, unified interface for discovering and requesting media content. With its modern design and seamless integration with popular media automation tools, Reiverr transforms how you interact with your media library. The combination of Klutch.sh’s simple deployment and Reiverr’s powerful features means you can focus on enjoying your content rather than managing infrastructure.