Tolgee

Developer and translator friendly web-based localization platform

  • ghcr.io/hsinghhira/tolgee:latest
  • v3.242.4
  • Updated 8 Nov 2026
  • port 6192
  • amd64 · arm64
  • Developer
  • 4.2k stars

Screenshots

Tolgee screenshot 1: TranslationsTolgee screenshot 2: Machine translationTolgee screenshot 3: SuggestionsTolgee screenshot 4: QA checksTolgee screenshot 5: Translation memory

Open the app

Web App

http://localhost:6192/

API docs

http://localhost:6192/swagger-ui.html

About Tolgee

Tolgee is a localization platform: keep every translation of your app in one place, translate in context and ship new texts without a new release. This is Tolgee in a single container, with PostgreSQL inside, one port and one data folder. The admin password is made for you on first start.

Features

  • Translation editor with keys, languages, tags, comments and screenshots
  • In-context translating: change texts right inside your running app with the Tolgee SDKs
  • Machine translation (Google, DeepL, AWS, Azure or an LLM) and translation memory
  • Import and export JSON, XLIFF, PO, Android, iOS and more; CLI and REST API
  • Teams, organizations, permissions, tasks and review states
  • Glossaries, QA checks and branching
  • PostgreSQL inside

How to use

  1. Open Tolgee from your dashboard.
  2. Sign in as admin with the password from the app log.
  3. Open the demo project, or create your own and add languages.

Before you install

Leave ADMIN_PASSWORD blank to get a random one, shown in the app log in the box marked CREDENTIALS. Tolgee works from every device with PUBLIC_URL left as it is; for links in emails and sign-in with GitHub or Google, set it to http://[ZIMAOS-IP-ADDRESS]:6192, like http://192.168.1.20:6192. Sign-up is off: invite people from your organization's Members page, or turn on TOLGEE_AUTHENTICATION_REGISTRATIONS_ALLOWED. Email, machine translation and the other settings are in the Variables tab; add them in the app settings. The first start takes about 3 minutes.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.
PUBLIC_URLhttp://localhost:6192The address of Tolgee. Tolgee works from every device with the default. For working links in emails and sign-in with GitHub or Google, change it to http://[ZIMAOS-IP-ADDRESS]:6192 or your https address. Keep the port at 6192.
ADMIN_PASSWORD—The password of the admin account. Leave it blank and the app makes a random one, shown in the app log in the box marked CREDENTIALS. Once you change it in Tolgee, Tolgee keeps yours.

Sign-up and accounts

VariableDefault valueDescription
TOLGEE_AUTHENTICATION_INITIAL_USERNAMEadminThe admin user name, made on the first start. Set it before the first start.
TOLGEE_AUTHENTICATION_REGISTRATIONS_ALLOWEDfalseSet to true to let anyone make an account. Otherwise the admin invites people.
TOLGEE_AUTHENTICATION_NEEDS_EMAIL_VERIFICATIONfalseSet to true so new accounts must confirm their email. Needs email (SMTP).
TOLGEE_AUTHENTICATION_USER_CAN_CREATE_ORGANIZATIONStrueSet to false so only the admin can create organizations.
TOLGEE_AUTHENTICATION_CREATE_DEMO_FOR_INITIAL_USERtrueSet to false to skip the demo project for the admin.
TOLGEE_AUTHENTICATION_ENABLEDtrueSet to false to turn sign-in off: everyone who opens Tolgee is the admin. Only for a computer nobody else can reach.

Email (SMTP)

VariableDefault valueDescription
TOLGEE_SMTP_HOST—Your email server, like smtp.gmail.com. Leave it out and no emails are sent.
TOLGEE_SMTP_PORT25Your email server port, usually 587 or 465.
TOLGEE_SMTP_USERNAME—The user name for your email server.
TOLGEE_SMTP_PASSWORD—The password for your email server.
TOLGEE_SMTP_AUTHfalseSet to true when your email server needs a user name and password.
TOLGEE_SMTP_TLS_ENABLEDfalseSet to true for STARTTLS (port 587).
TOLGEE_SMTP_SSL_ENABLEDfalseSet to true for TLS from the start (port 465).
TOLGEE_SMTP_FROM—The sender, like Tolgee <[email protected]>.

Sign in with GitHub or Google

VariableDefault valueDescription
TOLGEE_AUTHENTICATION_GITHUB_CLIENT_ID—GitHub OAuth app client ID. Its callback is PUBLIC_URL/login/auth_callback/github.
TOLGEE_AUTHENTICATION_GITHUB_CLIENT_SECRET—GitHub OAuth app client secret.
TOLGEE_AUTHENTICATION_GOOGLE_CLIENT_ID—Google OAuth client ID. Its redirect URI is PUBLIC_URL/login/auth_callback/google.
TOLGEE_AUTHENTICATION_GOOGLE_CLIENT_SECRET—Google OAuth client secret.

Machine translation

VariableDefault valueDescription
TOLGEE_MACHINE_TRANSLATION_GOOGLE_API_KEY—Your Google Cloud Translation API key.
TOLGEE_MACHINE_TRANSLATION_DEEPL_AUTH_KEY—Your DeepL API key.

Server

VariableDefault valueDescription
TOLGEE_MAX_UPLOAD_FILE_SIZE51200The largest file you can import or upload, in kilobytes.
JAVA_OPTS—Extra Java options, like -Xmx2g to give Tolgee more memory.
docker-compose.yml
name: tolgee

services:
  tolgee:
    image: ghcr.io/hsinghhira/tolgee:latest
    container_name: tolgee
    restart: unless-stopped
    stop_grace_period: 90s
    privileged: true
    environment:
      - TZ=$TZ
      - PUBLIC_URL=http://localhost:6192
      - ADMIN_PASSWORD=
    ports:
      - target: 8080
        published: "6192"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/actuator/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 240s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 3072M
        reservations:
          cpus: "0.10"
          memory: 768M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/icon.png
    x-casaos:
      id: com.icestore.tolgee
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: PUBLIC_URL
          description:
            en_US: >-
              The address of Tolgee. Tolgee works from every device with the
              default. For working links in emails and sign-in with GitHub or
              Google, change it to http://[ZIMAOS-IP-ADDRESS]:6192 or your
              https address. Keep the port at 6192.
        - container: ADMIN_PASSWORD
          description:
            en_US: >-
              The password of the admin account. Leave it blank and the app
              makes a random one, shown in the app log in the box marked
              CREDENTIALS. Once you change it in Tolgee, Tolgee keeps yours.
      ports:
        - container: "8080"
          description:
            en_US: Tolgee web app and API, published on host as 6192
      volumes:
        - container: /data
          description:
            en_US: >-
              The PostgreSQL database, uploaded files and screenshots, and
              this install's secret keys (state/secrets.env and
              tolgee/jwt.secret). Back up the whole folder.

x-casaos:
  id: com.icestore.tolgee
  architectures:
    - amd64
    - arm64
  main: tolgee
  author: HSinghHira
  category: Developer
  developer: tolgee
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-2.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-3.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-4.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tolgee/screenshot-5.jpg
  title:
    en_US: Tolgee
  tagline:
    en_US: Developer and translator friendly web-based localization platform
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/tolgee/](https://icestore.hsinghhira.me/app/tolgee/) for full details


      Tolgee is a localization platform: keep every translation of your app
      in one place, translate in context and ship new texts without a new
      release. This is Tolgee in a single container, with PostgreSQL inside,
      one port and one data folder. The admin password is made for you on
      first start.


      **Features**


      - Translation editor with keys, languages, tags, comments and
        screenshots

      - In-context translating: change texts right inside your running app
        with the Tolgee SDKs

      - Machine translation (Google, DeepL, AWS, Azure or an LLM) and
        translation memory

      - Import and export JSON, XLIFF, PO, Android, iOS and more; CLI and
        REST API

      - Teams, organizations, permissions, tasks and review states

      - Glossaries, QA checks and branching


      **How to use?**


      1. Open Tolgee from the Zima OS dashboard.


      2. Sign in as admin with the password from the app log.


      3. Open the demo project, or create your own and add languages.
  tips:
    before_install:
      en_US: >-
        1. Leave ADMIN_PASSWORD blank to get a random one. Or type your own.


        2. Leave PUBLIC_URL as it is to use Tolgee on your home network. For
           links in emails, set it to http://[ZIMAOS-IP-ADDRESS]:6192, like
           http://192.168.1.20:6192.


        3. More settings, like sign-up, email (SMTP), sign-in with GitHub or
           Google and machine translation, are listed on the Tolgee page at
           https://icestore.hsinghhira.me/app/tolgee/ (Variables tab). You can
           add them now or later in the app settings.


        4. Start the installation.


        5. Wait about 3 minutes for Tolgee to start the first time.


        6. Open the app log. Find the box marked CREDENTIALS. It has the
           admin user name and password.


        7. Open Tolgee from the Zima OS dashboard and sign in.
  index: /
  port_map: "6192"
  scheme: http
  is_uncontrolled: false
  version: "v3.242.4"
  update_at: "2026-11-08"
  release_notes:
    en_US: |-
      - Single-container Tolgee with one port (6192) and one data folder
      - PostgreSQL 17 inside, as upstream recommends; the image's bundled PostgreSQL 13 (gone in Tolgee v4) is not used
      - Sign-in is on, and the admin password is made on first start, so each install gets its own
      - tolgee/tolgee v3.242.4
  repo: "https://github.com/tolgee/tolgee-platform"
  support: "https://github.com/tolgee/tolgee-platform/issues"
  docs: "https://docs.tolgee.io/platform/self_hosting/configuration"

Install Tolgee

Something not working with Tolgee?

Report it so it gets fixed, or ask for an app that is not here yet.

More Developer apps

See all