Install Conzent OCI
on Your Website

Deploy your own consent management platform with Docker, then add the script to your website. Full control over your data.

Step 1 — Deploy Conzent OCI

Conzent OCI runs as a set of Docker containers. Clone the repository, configure your environment, and start the stack.

Clone the Repository

Clone the Conzent OCI repo from GitHub to your server.

Configure .env

Set APP_URL, APP_SECRET, database credentials, mail settings, and optional CDN URL.

Start Docker

Run docker compose -f docker-compose.oci.yml up -d to start all services.

Run Migrations

Run php bin/oci migrations:migrate inside the app container to set up the database.

Services included: Nginx (reverse proxy), PHP-FPM (application), MariaDB (database), Redis (cache & sessions), queue worker, and scheduler.
Step 2 — Create Your First Site

Log in to your Conzent dashboard, add a new site, and copy your unique Website Key. This key links the consent script to your site configuration.

Log In

Access your dashboard at the URL you configured as APP_URL. Create your account on first launch.

Add a Site

Go to Sites and create a new website. Enter your domain name and select your preferences.

Copy Website Key

Your unique Website Key is shown on the site detail page. Copy it for the next step.

Step 3 — Install the Script

Add the Conzent consent script to your website. The script points to your own Conzent OCI instance, so all data stays on your infrastructure.

Script Tag

Paste this in your HTML <head>, as close to the top as possible. Replace the placeholder values with your own.

<script async src="https://your-conzent-instance.com/c/consent.js"
    data-conzent="YOUR_WEBSITE_KEY"></script>
Important: When using Google Tag Manager, you must also insert the script tag near the top of your HTML <head>. This ensures scripts are blocked before consent is given.
Step 4 — Configure Your Banner

Customise the consent banner appearance, enable Google Consent Mode, and set up cookie categories from your dashboard.

Choose from box, banner, or popup layouts. Configure position, colours, and dark/light themes.

Set consent expiration, geo targeting, page reload behaviour, and button visibility.

Enable GCM Basic or Advanced mode. Optionally add IAB TCF v2.4 (2.3 + 2.2) for Google Ads compliance.

Languages & Content

Edit banner text, add translations, and customise button labels for each language.

Server Requirements

Conzent OCI is designed to run on any server with Docker support. Here's what you need.

Minimum Requirements
Requirement Details
Docker & Docker Compose Docker Engine 20+ with Compose V2
Memory 1 GB RAM minimum, 2 GB recommended
Storage 5 GB for application, database, and generated scripts
Network Port 80/443 accessible — HTTPS strongly recommended via reverse proxy
Operating System Any Linux distribution, macOS, or Windows with Docker Desktop
Included services: The Docker Compose stack includes Nginx, PHP-FPM, MariaDB, Redis, a queue worker, and a scheduler. No external dependencies required.