🐳 Firefox Sync Server image based on Python Alpine Linux
Switch branches/tags
Nothing to show
Clone or download
Latest commit 0c6e49a Dec 2, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.res Update logo Jun 7, 2018
examples/compose Formatting compose Sep 1, 2018
.dockerignore Review travis build Dec 3, 2018
.editorconfig Review travis build Dec 3, 2018
.gitignore Update gitignore Jul 27, 2018
.travis.yml Review travis build Dec 3, 2018
CHANGELOG.md Switch to Alpine 3.8 based image Jul 27, 2018
Dockerfile Coding style Dec 3, 2018
LICENSE Update docker, docker-compose, new year, notif webhook Jan 4, 2018
README.md Codacy Nov 18, 2018
build.sh Fix build script Dec 3, 2018
entrypoint.sh Coding style Dec 3, 2018


Version Build Status Docker Stars Docker Pulls Docker Repository on Quay Code Quality Donate Paypal


🐳 Firefox Sync Server image based on Python Alpine Linux.
If you are interested, check out my other 🐳 Docker images!



  • Alpine Linux 3.8

From docker-compose

  • Traefik as reverse proxy and creation/renewal of Let's Encrypt certificates


Environment variables

  • TZ : The timezone assigned to the container (default UTC)
  • FF_SYNCSERVER_PUBLIC_URL : Must be edited to point to the public URL of your server (default http://localhost:5000).
  • FF_SYNCSERVER_SECRET : This is a secret key used for signing authentication tokens. It should be long and randomly-generated.
  • FF_SYNCSERVER_ALLOW_NEW_USERS : Set this to false to disable new-user signups on the server. Only request by existing accounts will be honoured (default true).
  • FF_SYNCSERVER_FORCE_WSGI_ENVIRON : Set this to true to work around a mismatch between public_url and the application URL as seen by python, which can happen in certain reverse-proxy hosting setups (default false).


  • /data : Contains SQLite database


  • 5000 : Gunicorn port

Use this image

Docker Compose

Docker compose is the recommended way to run this image. You can use the following docker compose template, then run the container :

touch acme.json
chmod 600 acme.json
docker-compose up -d
docker-compose logs -f

Command line

You can also use the following minimal command :

$ docker run -d -p 5000:5000 --name firefox-syncserver \
  -e TZ="Europe/Paris" \
  -e FF_SYNCSERVER_SECRET="5up3rS3kr1t" \
  -v $(pwd)/data:/data \


Recreate the container whenever i push an update :

docker-compose pull
docker-compose up -d

How can I help ?

All kinds of contributions are welcome πŸ™Œ!
The most basic way to show your support is to star 🌟 the project, or to raise issues πŸ’¬
But we're not gonna lie to each other, I'd rather you buy me a beer or two 🍻!



MIT. See LICENSE for more details.