Back to all templates
LibreTranslate logo

LibreTranslate

Development2048MB+ RAM

Self-hosted machine translation API, an open source alternative to Google Translate

developmentailibretranslateopen-sourceself-hosteddocker

Deploy LibreTranslate in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select LibreTranslate

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy LibreTranslate on a VPS with Server Compass

Use the LibreTranslate template in Server Compass to deploy a self-hosted machine translation web UI and API on your VPS, then verify the translator loads.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a LibreTranslate app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for LibreTranslate

Use the template picker search to find LibreTranslate in the Server Compass template catalog.

Searching for LibreTranslate in the Server Compass template picker
4
Step 4

Select the LibreTranslate template

Choose the LibreTranslate template. Server Compass fills the LibreTranslate service, model cache volume, language list, and public web port.

LibreTranslate template selected in Server Compass
5
Step 5

Review the LibreTranslate settings

Confirm the app name, language model list, and compose service. In this run, the app was named libretranslate-demo and used host port 4035.

Reviewing LibreTranslate project settings and compose service
6
Step 6

Deploy LibreTranslate

Review the generated compose settings, confirm the LibreTranslate web port is available, and click Deploy.

Reviewing LibreTranslate web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the LibreTranslate image, starts the container, and verifies the stack.

Server Compass deploying the LibreTranslate template on the VPS
8
Step 8

Confirm LibreTranslate is running

After deployment finishes, return to the Apps tab and confirm the LibreTranslate app is marked Running with its application URL available.

LibreTranslate template running in the Server Compass Apps tab
9
Step 9

Open LibreTranslate in the browser

Open the application URL in a browser. The LibreTranslate translation page confirms the service is reachable after the models finish loading.

The deployed LibreTranslate web UI loaded in a browser

After LibreTranslate Opens

  • Put LibreTranslate behind HTTPS before exposing it publicly.
  • Require API keys before making the translation API public in production.
  • Keep the language list narrow if you want faster first startup and lower disk usage.
  • Monitor memory during large translations and model downloads.
  • Use the `/translate`, `/languages`, and `/detect` endpoints from applications that need translation.

Verified Result

The LibreTranslate web interface loaded successfully from the deployed container.

LibreTranslate deployment questions

What does the LibreTranslate template deploy?

It deploys LibreTranslate as a single-container translation web UI and API with a persistent model cache volume.

Which port did the tutorial use?

The tutorial used host port 4035, which maps to the LibreTranslate web UI on container port 5000.

Does LibreTranslate need setup after deployment?

No login setup is required by default. Wait for model downloads to finish, open the app URL, and run a test translation.

Should this become a blog post?

No. The deployment guide should live on the LibreTranslate template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying LibreTranslate with Server Compass, complete these steps to finish setup

1

Wait a few minutes for models to download on first start

2

Visit the web UI and run a test translation

3

Set LT_API_KEYS for authenticated access

4

Use /translate, /languages, /detect endpoints from your app

Need help? Check out our documentation for detailed guides.

LibreTranslate FAQ

Common questions about self-hosting LibreTranslate

How do I deploy LibreTranslate with Server Compass?

Simply download Server Compass, connect to your VPS, and select LibreTranslate from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for LibreTranslate?

LibreTranslate requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing LibreTranslate data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard LibreTranslate backup and restore procedures.

How do I update LibreTranslate to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest LibreTranslate image will be pulled and deployed with zero downtime.

Is LibreTranslate free to self-host?

LibreTranslate is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host LibreTranslate?

Download Server Compass and deploy LibreTranslate to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass