Discourse Translator

[Discourse]

	Summary	Discourse Translator translates posts on Discourse using Microsoft, Google, or Yandex translation APIs.
	Repository Link	https://github.com/discourse/discourse-translator
	Install Guide	How to install plugins in Discourse

As this is an official plugin maintained by the Discourse team, Support, Contribute > Bug, Contribute > UX, and Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

• Each post is only translated once per locale which saves you
  • Note that language detection is also run once for every post. Be careful when enabling this on old and large forums.
• Access Token is cached server side for faster translations.
• Translations are rate limited to 3 per minute by default (admins can configure this value)

Translation Services Supported

• Microsoft Translator
• Google Translate
• AWS Translate
• Yandex Translate
• LibreTranslate (open source)

Configuration Steps

Microsoft

1. Follow the steps in Microsoft Translator API on Azure to obtain a subscription key. You may pick from any of the available subscription offers.

2. In your Discourse, under Admin > Settings > Plugins, enter the subscription key that you’ve obtained from the steps above.

3. In your Discourse, under Admin > Settings > Basic Setup, enable allow user locale.

Google Translator

1. Go to https://console.developers.google.com

2. Click on My Project

3. Click on the to create a new project

4. Enter your project name and click create

5. Select Enable API and search for Google Cloud Translator API. Look for the enable button and click it to enable the API. Note that there is no free tier for the Google Translator API so it may prompt you to enable billing.

6. Once you’re done, click on credentials in the left menu

7. Click create credentials and select API key. Copy the API Key and paste it into the translator google api key site setting in Discourse.

8. In Discourse, under Admin > Settings > Basic Setup, enable allow user locale.

Settings

Name	Description
translator enabled	Allow inline translation of posts.
translator	The provider of the translation service.
translator azure subscription key	Azure Subscription Key
translator azure region	Azure Region
translator azure custom subdomain	Required if using a Virtual Network or Firewall for Azure Cognitive Services. Note: Only enter the custom subdomain not the full custom endpoint.
translator aws region	AWS Region
translator aws key id	AWS Key ID
translator aws secret access	AWS secret access key
translator aws iam role	AWS IAM Role
translator google api key	Google API Key
translator yandex api key	Yandex API Key
translator libretranslate endpoint	LibreTranslate Endpoint
translator libretranslate api key	LibreTranslate API Key
max translations per minute	The number of translations per minute a regular user can perform.
restrict translation by group	Only allowlisted groups can translate
restrict translation by poster group	Only allow translation of posts made by allowlisted users

Known Issues

• Does not translate text within polls generated by discourse-poll plugin.
• Images are enlarged upon translating.

Hosted by us? This plugin is available on our Enterprise plan.

Last edited by @nat 2026-08-18T10:38:55Z

Check document

Perform check on document:

[packman (Chris McMahon)]

저는 과거에 잘 작동했던 자체 호스팅된 LibreTranslate를 사용 중인데, 최근 “Job exception: The translator service is currently not available”(작업 예외: 번역 서비스가 현재 사용 불가능합니다) 오류가 반복적으로 발생하고 있습니다. URL을 확인해 보았는데, 과거에는 정상적으로 작동했습니다. 해당 URL에 접근하면 LibreTranslate 웹 페이지가 정상적으로 표시됩니다. LibreTranslate 인스턴스가 인터넷 접근이 없는 비공개 환경이므로 API 토큰이 필요 없습니다.

백트레이스는 다음과 같습니다:

Message (548 copies reported)

Job exception: The translator service is currently not available.

Backtrace

/var/www/discourse/plugins/discourse-translator/services/discourse_translator/libretranslate.rb:168:in `result'
/var/www/discourse/plugins/discourse-translator/services/discourse_translator/libretranslate.rb:85:in `detect'
/var/www/discourse/plugins/discourse-translator/plugin.rb:120:in `block in execute'
/var/www/discourse/lib/distributed_mutex.rb:53:in `block in synchronize'
/var/www/discourse/lib/distributed_mutex.rb:49:in `synchronize'
/var/www/discourse/lib/distributed_mutex.rb:49:in `synchronize'
/var/www/discourse/lib/distributed_mutex.rb:34:in `synchronize'
/var/www/discourse/plugins/discourse-translator/plugin.rb:119:in `execute'
/var/www/discourse/app/jobs/base.rb:305:in `block (2 levels) in perform'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/rails_multisite-6.0.0/lib/rails_multisite/connection_management/null_instance.rb:49:in `with_connection'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/rails_multisite-6.0.0/lib/rails_multisite/connection_management.rb:21:in `with_connection'
/var/www/discourse/app/jobs/base.rb:292:in `block in perform'
/var/www/discourse/app/jobs/base.rb:288:in `each'
/var/www/discourse/app/jobs/base.rb:288:in `perform'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:202:in `execute_job'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:170:in `block (2 levels) in process'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/middleware/chain.rb:177:in `block in invoke'
/var/www/discourse/lib/sidekiq/pausable.rb:132:in `call'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/middleware/chain.rb:179:in `block in invoke'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/middleware/chain.rb:182:in `invoke'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:169:in `block in process'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:136:in `block (6 levels) in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/job_retry.rb:113:in `local'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:135:in `block (5 levels) in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq.rb:44:in `block in <module:Sidekiq>'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:131:in `block (4 levels) in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:263:in `stats'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:126:in `block (3 levels) in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/job_logger.rb:13:in `call'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:125:in `block (2 levels) in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/job_retry.rb:80:in `global'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:124:in `block in dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/job_logger.rb:39:in `prepare'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:123:in `dispatch'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:168:in `process'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:78:in `process_one'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/processor.rb:68:in `run'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/component.rb:8:in `watchdog'
/var/www/discourse/vendor/bundle/ruby/3.3.0/gems/sidekiq-6.5.12/lib/sidekiq/component.rb:17:in `block in safe_thread'

이 문제를 해결하는 방법에 대해 어떤 생각이 있으신가요?

[Bathinda (Bathinda Helper)]

‘힌디어’ 로케일 옵션은 아직 'Discourse’에서 사용할 수 없습니다. 하지만 ‘힌디어’ 번역은 다른 서비스(저는 'Microsoft Azure’를 사용 중입니다)를 통해 가능합니다.

그렇다면 Discourse 인터페이스는 영어로 유지하면서 모든/일부 비힌디어 게시물을 '힌디어’로 번역하도록 설정하는 방법은 무엇일까요? 이것이 가능한가요?

[sunjam (james.network)]

@packman

저는 LibreTranslate를 자체 호스팅으로 사용하고 있습니다.

이 질문을 그들의 디스커스 포럼에도 크로스포스팅해 보려 합니다.

LibreTranslate Community

[Maria]

저희 포럼에 이 번역기를 추가하는 것에 대해 생각 중입니다. 하지만 두 가지 주요 우려 사항이 있습니다:

1. 번역을 수정할 수 있나요?
특정 용어가 일관되게 번역되도록 보장해야 합니다. 이를 위해 사용 가능한 번역을 확인하고 필요 시 수정할 수 있는 기능이 필요합니다.

2. 게시물이 '재번역’되는 시점은 언제인가요?
일부 포럼 게시물은 자주 수정됩니다. 오탈자 수정이 과도한 번역 비용으로 이어지지 않도록 어떻게 보장할 수 있을까요? 또한, 새로운 변경 사항이 번역에 정확히 반영되도록 어떻게 확인할 수 있을까요?

[ludwikc (Ludwik C. Siadlak)]

@Maria

1. 번역을 수정할 수 있나요?

벤더(Microsoft/Google) 수준에서 수정해야 하므로 가능하지 않을 것 같습니다. 단, 번역된 내용이 단어 치환 기능의 대상이라면 해당 기능을 사용할 수 있습니다.

다만 다음과 같은 기능 요청을 드립니다:

1. 첫 번째 게시글이 다른 언어로 작성된 경우 영어로 자동 번역합니다.
2. 전체 스레드를 한 번에 번역할 수 있는 버튼을 제공합니다.
3. 사용자 수준에서 전체 포럼에 대한 자동 번역 기능을 활성화합니다. 즉, 사용자가 프로필에서 루마니아어만 사용한다고 설정하면 모든 콘텐츠가 루마니아어로 번역됩니다. 여러 언어를 사용한다고 설정한 경우, 해당 언어가 아닌 게시글만 번역됩니다.

[icaria36]

사이트 관리자로서 이 글을 보고 놀랐습니다:

이 숨겨진 설정은 어디에 있나요?

[Jagster (Jakke Flemming)]

./launcher enter app
rails c
SiteSetting.automatic_translation_backfill_rate = <원하는 값>
exit
exit

하지만 더 최신 버전에서는 더 이상 존재하지 않는 것 같습니다.

[icaria36]

이런 것들은 어떻게 배우나요? 네, 감사합니다! 확실하도록 팀의 답변을 기다리겠습니다.

[Jagster (Jakke Flemming)]

두 가지 방법: 검색과 ask.discourse.com를 사용하는 것입니다

[Canapin (Coin-coin le Canapin)]

숨겨진 사이트 설정 사용

이 가이드는 숨겨진 사이트 설정에 대한 how-to(가이드)로, 설정을 활성화하는 방법과 조정할 가치가 있는 이유를 설명합니다. 필요한 사용자 권한: 관리자(Administrator) 중요: 일부 단계에는 콘솔 접근 권한이 필요합니다. Discourse에서 숨겨진 사이트 설정은 표준 관리자 대시보드 인터페이스에서 바로 보거나 접근할 수 없는 구성 옵션을 의미합니다. 이러한 설정은 사이트의 다양한 고급 또는 잠재적으로 영향이 큰 기능을 제어할 수 있는 백엔드 구성의 일부입니다. 이러한 숨겨진 설정은 일반적인 사용 사례와 모범 사례에 기반하여 최적의 성능과 보안을 보장하도록 설정된 기본값이 미리 구성되어 있습니다. 숨겨진 설정은 그 함의를 완전히 이해하지 못할 수 있는 관리자가 실수로 잘못 설정하는 것을 방지하기 위해 기본 설정 인터페이스에서 숨겨져 있습니다. 이는 다음과 같은 경우를 위해 inte…

[twofoursixeight]

제목이 번역된 주제의 알림이 알림 바에서 번역되지 않는 것으로 보입니다:

Discourse에서 특정 사용자를 찾는 방법

저는 Discourse를 처음 사용하는 사용자입니다. 다른 사용자를 검색하고 싶은데, 오른쪽 위 확대경 아이콘으로 사용자를 검색할 수 없습니다.

[twofoursixeight]

또한 내 게시물이 링크를 통해 잘못된 언어로 번역되었습니다.

편집기에서 확인해보니, 실제로 제가 작성한 내용은 다음과 같습니다:

번역할 때 원박스(oneboxing)도 작동하지 않는 것을 확인했습니다.

[nat (Natalie T)]

스크린샷에 있는 알림은 게시물의 주제 제목 원문이 사용되었으므로, 현재로서는 “올바른” 상태입니다. 향후 알림(주제 제목)이 번역되도록 조치할 예정입니다.

위 게시물에 대해서는 기계 번역이 오류를 일으켜 "스페인어(es)"로 잘못 감지되었고, 이후에도 번역 품질이 좋지 않았습니다. 현재는 수정이 완료되었습니다. 더 나은 프롬프트를 사용하여 번역 과정을 개선하고 있습니다.

[翔_贺]

discourse-translator 플러그인을 설치할 때 이 오류가 발생했습니다. 제 discourse 버전은 3.5.0.beta1입니다.

I, [2025-04-24T01:33:20.510994 #1]  INFO -- : > cd /var/www/discourse && su discourse -c 'bundle exec rake db:migrate'
        82: from /usr/local/bin/bundle:25:in `<main>'
        81: from /usr/local/bin/bundle:25:in `load'
        80: from /usr/local/lib/ruby/gems/3.3.0/gems/bundler-2.5.18/exe/bundle:20:in `<top (required)>'
     ....
        10: from /var/www/discourse/vendor/bundle/ruby/3.3.0/gems/activesupport-7.2.2.1/lib/active_support/lazy_load_hooks.rb:87:in `with_execution_control'
        9: from /var/www/discourse/vendor/bundle/ruby/3.3.0/gems/activesupport-7.2.2.1/lib/active_support/lazy_load_hooks.rb:94:in `block in execute_hook'
        8: from /var/www/discourse/config/application.rb:249:in `block in <class:Application>'
        7: from /var/www/discourse/lib/plugin.rb:6:in `initialization_guard'
        6: from /var/www/discourse/config/application.rb:249:in `block (2 levels) in <class:Application>'
        5: from /var/www/discourse/config/application.rb:249:in `each'
        4: from /var/www/discourse/lib/plugin/instance.rb:629:in `notify_after_initialize'
        3: from /var/www/discourse/lib/plugin/instance.rb:629:in `each'
        2: from /var/www/discourse/lib/plugin/instance.rb:631:in `block in notify_after_initialize'
        1: from /var/www/discourse/plugins/discourse-translator/plugin.rb:40:in `block in activate!'
/var/www/discourse/plugins/discourse-translator/lib/discourse_translator/inline_translation.rb:86:in `inject': protected method `register_topic_preloader_associations' called for an instance of Plugin::Instance (NoMethodError)

이 문제를 어떻게 수정할 수 있을까요?

[nat (Natalie T)]

안녕하세요, 플러그인을 설치하기 전에 먼저 Discourse를 업데이트하면 이 오류를 완화할 수 있습니다.

register_topic_preloader_associations 메서드가 protected에서 public으로 변경되었습니다.

[翔_贺]

감사합니다. Discourse를 최신 버전으로 업그레이드한 후에 성공적으로 설치했습니다.