Try describing what you need:

Lingarr logo

Lingarr

★ 910
GNU Affero General Public License v3.0Open Source — No Paywall10 Containers — 10 containers — heavy hosting footprintDocker · ComposeNeeds MariaDB19+ active committers (12mo)

About

Lingarr is a self-hosted subtitle translation application designed for users who want to automate translating subtitle files into another language. It supports a broad range of translation backends,...

Community Ratings

No ratings yet

Features

  • automatic subtitle translation
  • multiple translation services
  • REST API
  • Swagger API documentation
  • multi-architecture Docker images
  • support for LibreTranslate
  • support for local AI via Ollama or OpenAPI-compatible models
  • support for DeepL
  • support for major AI providers and translation services

Details

Last Updated
Nov 20, 2026
Created
Dec 20, 2023
Install Methods
dockerdocker-compose
Requirements
MySQLPostgreSQLSQLiteMariaDBDocker
Default Port
9876web UI
API
REST
Backup & Export
file-backupdatabase-dump
Runtime / Stack
Docker
Privacy & Independence
Cloud: Optional
Deployment

Deployment: Docker Compose ✓10 Containers — heavy hosting footprintRuns as 10 containers

Run Lingarr yourself

Pick how much you want to manage.

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 Lingarr with Docker Compose

Compose file from the Lingarr project repository.

10 services · database: mariadb · infra: traefik, mariadb, postgres · 5 unclassified (node, libretranslate, phpmyadmin, radarr, sonarr)

no resource limits declared

needs persistent storage (14 volumes)

docker-compose.dev.yml · @ 9fba9f7 · scanned Nov 3, 2026

# This is a development Docker Compose file.
# It is intended for development purposes only and should not be used as a production example.
# Misuse in production environments may lead to unexpected behavior or security risks.

networks:
  lingarr:
    external: true

services:
  Lingarr.Server:
    extra_hosts: # added for ollama 
      - "host.docker.internal:host-gateway"
    container_name: Lingarr.Server
    image: ${DOCKER_REGISTRY-}lingarrserver
    build:
      context: .
      dockerfile: Lingarr.Server/Dockerfile
      args:
        BUILD_CONFIGURATION: ${BUILD_CONFIGURATION:-Debug}
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - BASE_PATH=/lingarr
    
      - DB_CONNECTION=mysql
      - DB_HOST=Lingarr.Mysql
      - DB_PORT=3306
      - DB_DATABASE=Lingarr
      - DB_USERNAME=Lingarr
      - DB_PASSWORD=Secret1234

#      - DB_CONNECTION=postgresql
#      - DB_HOST=Lingarr.Postgres
#      - DB_PORT=5432
#      - DB_DATABASE=Lingarr
#      - DB_USERNAME=Lingarr
#      - DB_PASSWORD=Secret1234
      
      - SERVICE_TYPE=libretranslate
      - LIBRE_TRANSLATE_URL=http://libretranslate:5000
      - SOURCE_LANGUAGES=[{"name":"English","code":"en"},{"name":"Dutch","code":"nl"}]
      - TARGET_LANGUAGES=[{"name":"Turkish","code":"tr"},{"name":"Dutch","code":"nl"}]
      - ASPNETCORE_URLS=http://+:9876
      - ASPNETCORE_HTTP_PORTS=9876
      - PLUGINS_PATH=/app/plugins # Use when plugins exist
    volumes:
      - ../media/data/movies:/movies
      - ../media/data/tv:/tv
      - ../media/data/series/anime:/anime
      - ../media/data/config:/app/config
      - ./samples/CloudflarePlugin/bin/Debug/net10.0:/app/plugins:ro # Mount the plugins
    ports:
      - "9877:9876"
    networks:
      - lingarr
    depends_on:
      Lingarr.Mysql:
        condition: service_healthy
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=lingarr"
      - "traefik.http.services.lingarr.loadbalancer.server.port=9876"
      
      # Prefix /lingarr: http://lingarr.localhost/lingarr
      - "traefik.http.routers.lingarr-pfx.rule=Host(`lingarr.localhost`) && PathPrefix(`/lingarr`)"
      - "traefik.http.routers.lingarr-pfx.entrypoints=web"
      - "traefik.http.routers.lingarr-pfx.service=lingarr"
      - "traefik.http.routers.lingarr-pfx.middlewares=lingarr-prefix"
      - "traefik.http.middlewares.lingarr-prefix.headers.customrequestheaders.X-Forwarded-Prefix=/lingarr"

  Lingarr.Traefik:
    image: traefik:v3
    container_name: Lingarr.Traefik
    command:
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--api.dashboard=true"
      - "--api.insecure=true"
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - lingarr

  Lingarr.Client:
    image: ${DOCKER_REGISTRY-}lingarrclient
    container_name: Lingarr.Client
    build:
      context: ./Lingarr.Client/
      dockerfile: Dockerfile
    ports:
      - "9876:9876"
    volumes:
      - ./Lingarr.Client:/app:rw
      - ./Lingarr.Client/node_modules:/app/node_modules
    tty: true
    command: /bin/sh -c "npm install && npm run dev"
    networks:
      - lingarr

  Lingarr.Docs:
    image: node:alpine
    container_name: Lingarr.Docs
    working_dir: /app
    ports:
      - "9879:5173"
    volumes:
      - ./Lingarr.Docs:/app:rw
      - ./Lingarr.Docs/node_modules:/app/node_modules
    tty: true
    command: /bin/sh -c "npm install && npm run dev -- --host"
    networks:
      - lingarr

  LibreTranslate:
    container_name: LibreTranslate
    image: libretranslate/libretranslate:latest
    restart: unless-stopped
    environment:
      - LT_LOAD_ONLY=en,tr,nl,pt
      - LT_DISABLE_WEB_UI=false # Optional, enable if you would like to make use of the LibreTranslate web interface 
    ports:
      - 5000:5000
    volumes:
      - ../media/libretranslate:/home/libretranslate/.local/share/argos-translate
    networks:
      - lingarr
    healthcheck:
      test: ["CMD-SHELL", "./venv/bin/python scripts/healthcheck.py"]

  Lingarr.Mysql:
    image: mariadb:latest
    container_name: Lingarr.Mysql
    tty: true
    ports:
      - "1433:3306"
    environment:
      MYSQL_DATABASE: Lingarr
      MYSQL_USER: Lingarr
      MYSQL_PASSWORD: Secret1234
      MYSQL_ROOT_PASSWORD: Secret1234
      SERVICE_TAGS: dev
      SERVICE_NAME: mariadb
    networks:
      - lingarr
    healthcheck:
      test: "mariadb $$MYSQL_DATABASE -u$$MYSQL_USER -p$$MYSQL_PASSWORD -e 'SELECT 1;'"
      interval: 10s
      timeout: 5s
      retries: 5

  Lingarr.Postgres:
    image: postgres:16-alpine
    container_name: Lingarr.Postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: Lingarr
      POSTGRES_USER: Lingarr
      POSTGRES_PASSWORD: Secret1234
    ports:
      - "5432:5432"
    networks:
      - lingarr
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U Lingarr -d Lingarr"]
      interval: 10s
      timeout: 5s
      retries: 5
      
  Lingarr.PHPMyAdmin:
    image: phpmyadmin/phpmyadmin:5.0.1
    container_name: Lingarr.PHPMyAdmin
    environment:
      PMA_HOST: Lingarr.Mysql
      PMA_USER: Lingarr
      PMA_PASSWORD: Secret1234
      UPLOAD_LIMIT: 500M
    ports:
      - "9878:80"
    networks:
      - lingarr
  
  radarr:
    image: ghcr.io/hotio/radarr:nightly
    container_name: radarr
    environment:
      - TZ=Europe/Amsterdam
    volumes:
      - ../media/data/movies:/movies
    restart: unless-stopped
    ports:
      - 7878:7878
    networks:
      - lingarr

  sonarr:
    image: ghcr.io/hotio/sonarr:nightly
    container_name: sonarr
    environment:
      - TZ=Europe/Amsterdam
    volumes:
      - ../media/data/tv:/tv
      - ../media/data/series/anime:/anime
    restart: unless-stopped
    ports:
      - 8989:8989
    networks:
      - lingarr

#  localai:
#    container_name: localai
#    image: localai/localai:latest-aio-cpu
#    ports:
#      - 8080:8080
#    environment:
#      - 'PRELOAD_MODELS=[{"url": "github:go-skynet/model-gallery/mistral.yaml", "name": "mistral"}]'
#    stdin_open: true
#    tty: true
#    networks:
#      - lingarr

This file may be out of date. Check the Lingarr 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.

Metadata extracted from README on Aug 23, 2026

Related Software

Libre Translate logo

Libre Translate

17.8k
A free and open source machine translation API that is entirely self-hosted.
Miscellaneous ToolsCopyleft LicenseSoftware Localization+2
Single Container
Details
SnapOtter logo

SnapOtter

3.0k
SnapOtter is a self-hosted file-processing suite for converting, compressing, OCRing, transcribing, and editing files across image, video, audio, PDF, and document workflows.
Media ManagementArtificial IntelligenceAI Media Generation+3
3 ContainersTelemetry: Opt-Out
Details
MKVPriority logo

MKVPriority

76
MKVPriority scores MKV audio and subtitle tracks and updates their flags in place to favor the best tracks without remuxing.
Media ManagementPermissive LicenseAutomation Tools
Details
Deleterr logo

Deleterr

339
Intelligent media library cleanup for Plex that automatically identifies and deletes media based on configurable rules.
Media ManagementAutomation ToolsSelf Hosting Solutions+1
Single Container
Details
yt-dlp Web UI logo

yt-dlp Web UI

2.6k
A web UI and RPC server for yt-dlp that helps fetch videos and monitor upcoming livestreams.
Media ManagementCopyleft LicenseMedia Servers+2
Single Container
Details
Ombi logo

Ombi

4.1k
Ombi is a media request tool that syncs with media servers and lets users request movies, music, and TV shows.
Media ManagementAutomation ToolsSelf Hosting Solutions+1
Details
SyncTube logo

SyncTube

398
SyncTube is a synchronized video-watching app with chat, playback control, and subtitle support that can be run locally or with Docker.
Media ServersMedia ManagementCustom Communications+2
Details
Yamtrack logo

Yamtrack

3.9k
Yamtrack is a self-hosted media tracker for movies, TV shows, anime, manga, video games, books, comics, and board games.
Miscellaneous ToolsCopyleft LicenseMedia Management+4
2 Containers
Details