# Deploy SuggestArr with Easypanel

URL: /templates/suggestarr

SuggestArr is a self-hosted media automation tool that monitors recently watched content from Jellyfin, Plex, or Emby, discovers similar movies and TV shows via the TMDb API, and automatically submits download requests to Jellyseerr or Overseerr. It runs on a configurable cron schedule, supports AI-powered recommendations through any OpenAI-compatible LLM (Ollama, OpenRouter, etc.), and provides a web UI for managing services, schedules, users, and real-time logs. All data is persisted to a single SQLite database stored in the config volume — no external database is required.

## Installation notes

After deployment open the app URL. A setup wizard will guide you through creating an admin account, entering your TMDb API key, connecting your media server (Jellyfin, Plex, or Emby), and configuring your Jellyseerr or Overseerr instance. Optionally link Trakt accounts per-user from the Profile page after setup.

## Benefits

### Automatic Media Suggestions

Monitors what you and your users recently watched and automatically requests similar content — no manual searching or queue management needed.

### Multi-Server Support

Works with Jellyfin, Plex, and Emby media servers and submits requests to either Jellyseerr or Overseerr, fitting into your existing *arr stack without changes.

### AI-Powered Recommendations

Optionally routes suggestion queries through any OpenAI-compatible LLM (Ollama, OpenRouter, OpenAI) for higher-quality, context-aware recommendations beyond TMDb similarity.

## Features

### Cron-Scheduled Automation

Runs discovery and request jobs on a configurable schedule so new suggestions are queued regularly without manual triggers.

### Per-User Tracking

Tracks watch history per user and tailors suggestions individually, allowing fine-grained control over who gets automated requests.

### Trakt Integration

Links Trakt accounts per-user via OAuth to enrich watch history with ratings and list data for better recommendations.

### Real-Time Logs and Web UI

Built-in web interface shows live job logs, request history, and service connection status so you can monitor activity without SSHing into the container.

### TMDb-Powered Discovery

Uses the TMDb API to find similar titles, fetch metadata, and check availability before submitting requests to your Seer instance.

## Configuration

- `appServiceName` (App Service Name, required): suggestarr

- `appServiceImage` (App Service Image, required): ciuse99/suggestarr:v2.9.1

## Services

- suggestarr: app (ciuse99/suggestarr:v2.9.1)

## Resources

- [Website](https://giuseppe99barchetta.github.io/SuggestArr/)

- [GitHub](https://github.com/giuseppe99barchetta/SuggestArr)

- [Documentation](https://giuseppe99barchetta.github.io/SuggestArr/)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/suggestarr)