How to deploy Metabase on Zenifra

Metabase can be deployed on Zenifra as an HTTP project from the official image. This guide shows the recommended configuration, the required variables, and how to validate the result.

Prerequisites

• A verified account and access to the console.
• Permission to create projects in the organization (project.create).
• Credit or a saved card for the selected plan; see Payment models.

Quick option: template

Metabase is in the public Templates catalog. Use Deploy to create the application with the recommended configuration, or Customize to review plan, storage, and variables and optionally create a database with it before confirming. The steps below show a manual configuration from the official image.

Step 1: create the HTTP project

In the console, click + Create Project, choose HTTP, and fill in:

Pick a name between 6 and 32 characters, using lowercase letters, numbers, and hyphens; it also defines the *.clients.zenifra.com address. For testing, hourly billing is the cheapest; for continuous use, compare it with monthly.

Storage

Not needed when Metabase uses a managed PostgreSQL as its application database (recommended). Without an external database, Metabase writes its settings to a local file, which is lost on restart.

Step 2: configure environment variables

Add the variables below in the Environment variables step:

MB_DB_TYPE=postgres
MB_DB_HOST=<postgresql-host>
MB_DB_PORT=<postgresql-port>
MB_DB_DBNAME=app
MB_DB_USER=app
MB_DB_PASS=<postgresql-password>

First create a managed PostgreSQL and copy the host, port, and password from the console. For a quick test you can omit these variables, knowing settings will be lost on restart. See Environment variables.

Step 3: create and validate

Review the estimated cost and click Create Project. When it finishes, the console opens the project page with the public address.

Open the project URL. Metabase may take a few minutes to start the first time; follow the project logs until the interface responds. Finish the setup wizard by creating the admin account and connect your first data source.

If the application does not respond, check the project logs, the configured port, and the troubleshooting guide.

Production recommendations

• Always use the managed PostgreSQL as the application database.
• Connect Metabase to your data with a read-only user.
• Restrict access by IP with access control when your plan allows it.

To remove the project, open it in Projects and click Delete. Deletion is permanent and erases storage.

Next steps

• More examples
• Persistent storage
• Custom domains
• Project metrics and logs