Skip to main content

Docker Images

Every application deployed on Fransys is packaged as a Docker image. Depending on your configuration, the image is either built automatically by Fransys or provided from an external registry.

Automatic builds​

For blocks connected to a Git repository (GitLab, GitHub), Fransys handles the build automatically:

  • Dockerfile detection — Fransys uses the Dockerfile at the root of your repository
  • Build on every push — A new build is triggered with every push to the configured branch
  • Internal registry — The image is stored in the Fransys registry, with no additional configuration

You don't have to configure a registry, credentials, or build pipeline — the automatically generated CI handles it.

External images​

For blocks in External mode, you directly specify a public or private Docker image:

  • Public image — Enter the image name (e.g., nginx, node:20, n8n)
  • Private image — Enable Docker registry authentication and enter your credentials to access a private registry (Docker Hub, GitHub Container Registry, GitLab Registry, etc.)

Best practices​

  • Use automatic CI when you have the source code — the build and push are handled effortlessly.
  • Use External mode for third-party services (n8n, Ollama, Metabase, etc.) or when you already have an existing build pipeline.
  • Version your images with explicit tags rather than latest to facilitate debugging and rollbacks.