Skip to content

Translate App

About

Free and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.

This package is proudly built from LibreTranslate's open source software.

No affiliation or endorsement

Please note that Cloudron has no affiliation with LibreTranslate and this package is not endorsed by them.

Trademark requirements

Please conform to Trademark requirements, when using this app.

Languages

By default the app comes with EN and DE installed. If more languages are wanted, update LT_LANGUAGE_MODELS variable in /app/data/env.sh, and restart the app. e.g.

export LT_LANGUAGE_MODELS=en,de,fr

To remove languages, update LT_LANGUAGE_MODELS variable appropriately, remove /app/data/argos-translate folder and restart the app.

User Management

The app has no user management of it's own. By default, anyone (without a token) can make 30 requests per minute. You can change this in /app/data/env.sh.

Custom config

Custom environment variables can be set in /app/data/env.sh using the File manager.

API

By default, the API can be used without a key to make 30 requests per minute:

$ curl -d "q=cloudron%20ist%20wunderbar&source=de&target=en" -X POST https://translate.domain.com/translate

To lock the app and enforce use of a key, set the below in /app/data/env.sh:

export LT_REQUIRE_API_KEY_ORIGIN=true
export LT_REQ_LIMIT=0

Create Key

Use the ltmanage command to create an API key. On Cloudron, LibreTranslate runs as the cloudron user. Run the following command using a Web Terminal to create an API with a limit of 120 requests per minute:

su - cloudron -c 'source /app/code/.venv/bin/activate; ltmanage keys --api-keys-db-path /app/data/db/api_keys.db add 120'
f67d5afe-aa14-4d37-90f7-f7d9636b721e

The key can be used as follows:

curl -d "q=cloudron%20ist%20wunderbar&api_key=f67d5afe-aa14-4d37-90f7-f7d9636b721e&source=de&target=en" -X POST https://translate.domain.com/translate

Exising api keys can also be listed with

su - cloudron -c 'source /app/code/.venv/bin/activate; ltmanage keys --api-keys-db-path /app/data/db/api_keys.db'

and then also revoked with

su - cloudron -c 'source /app/code/.venv/bin/activate; ltmanage keys --api-keys-db-path /app/data/db/api_keys.db remove <key>'