Deploy a Custom Docker Container

This guide shows you how to deploy any Docker image on Fransys — whether it's a third-party service (nginx, Metabase, Grafana) or your own containerized application.

Prerequisites

• A Fransys account with credits
• A deployed cluster with Healthy status
• A created project

Step 1 — Add a Docker block

From your project's canvas, drag an Application block from the left sidebar.

In the block configuration:

• Platform → Docker
• Code source → External (for a public Docker image)

Step 2 — Provide the Docker image

In the Docker image field, enter the image name:

• Public image: nginx, metabase/metabase, n8nio/n8n
• Image with tag: node:20, postgres:16
• Image from a private registry: enable Docker registry authentication and enter your credentials

Set the Container port — the port your container listens on (e.g., 80 for nginx, 3000 for Metabase).

Step 3 — The interface enriches

As soon as the image is provided, new tabs automatically appear in the block's sidebar:

• Recurring — Recurring tasks (cron jobs)
• Resources — CPU/RAM requests and limits
• Storage — Persistent volumes
• Environment variables — Environment variables
• Deployment commands — Commands executed on deployment

The Ingress section also appears in the general configuration with:

• Enabled → ON
• An auto-generated URL at *.fransysapp.com

And the Egress section for configuring outbound traffic.

Step 4 — Configure (optional)

Depending on your service, you can:

• Add environment variables — In the Environment variables tab, add the variables expected by your service
• Attach a volume — In the Storage tab, define a persistent volume if your service stores data
• Connect a database — Drag a PostgreSQL or Redis block onto the canvas and draw a link to your Docker block — connection variables are automatically injected
• Define deployment commands — Commands to execute after each deployment

Step 5 — Select the cluster and deploy

1. In the top right of the canvas, click Select cluster and choose your cluster
2. Click Deploy

Step 6 — Access your service

Once the deployment is complete, open the block configuration. The URL at *.fransysapp.com in the Ingress section is your access point — in HTTPS, with automatic SSL certificate.

tip

To use your own domain, check out the guide Add a custom domain.

Common image examples

Service	Image	Port
Nginx	nginx	80
Metabase	metabase/metabase	3000
n8n	n8nio/n8n	5678
Grafana	grafana/grafana	3000
Ollama	ollama/ollama	11434

→ Learn more: Application Blocks · Docker Images