Welcome to Pontoon Debian Administrator’s Manual!

This manual documents the installation and the maintenance of Pontoon on Debian and Ubuntu.

Contents:

• Foreword
  • What is Pontoon?
  • What is Pontoon Debian?
  • Targeted Systems
  • Warranty
• Getting Pontoon
  • Prebuilt Pontoon Debian Tarball
  • Building Pontoon Debian Tarball
  • Building Pontoon Debian Tarball using Docker
• Installing Pontoon on Debian and Ubuntu
  • Requirements
  • PostgreSQL
  • Pontoon
  • Scheduled Tasks (cron)
  • Startup Configuration (systemd)
  • Nginx
• Backuping and Restoring Pontoon
  • What to Backup?
  • Backuping Pontoon
  • Restoring Pontoon
• Updating Pontoon
  • Migration Guide
  • Pontoon Debian v2025.11.05
  • Pontoon Debian v2025.04.09
  • Pontoon Debian v2024.12.13
  • Pontoon Debian v2024.01.16
  • Pontoon Debian v2023.11.06
  • Pontoon Debian v2023.08.16
  • Pontoon Debian v2023.05.02
  • Pontoon Debian v2023.02.14
  • Pontoon Debian v2022.09.12
  • Pontoon Debian v2022.06.27
  • Pontoon Debian v2022.04.26
  • Pontoon Debian v2022.02.09
  • Pontoon Debian v2021.12.06
  • Pontoon Debian v2021.09.23
  • Pontoon Debian v2021.03.23
• Frequently Asked Questions
  • Where can I find the Pontoon’s logs?
  • How to access the Django Admin?
• Troubleshooting
  • Errors about unpinned modules during pip install
  • Missing “distutils” module when running “manage.py” commands
  • Permission issue on database migration (psycopg2 permission denied)
  • Error 500 with “Invalid HTTP_HOST header” error in the logs
  • pontoon.sync.repositories.utils.PullFromRepositoryException
• Contributing
  • Questions
  • Bugs
  • Pull Requests
  • Building the Documentation