Installation

Pick your stack

Banimark is a PHP application that runs on your own server. If your app is PHP it goes inside it; if it is not, Banimark runs quietly beside it on the same hostname. Every guide ends with a working chat widget and an AI that can answer from your database.

You only do this once. Every version after it installs itself from a button in your own admin panel — no terminal, no developer, and a way back if you need one.

Before you start

What every install needs

The same short list whatever your stack. If you are on shared hosting, the only line worth checking with your host in advance is the ionCube one.

NeedsWhy
PHP 8.2 or newerThe engine ships encoded for PHP 8.2, and an 8.2 build runs on 8.2 and later — it will not run on 8.1 at all. We test on 8.2 and 8.3.
ext-curl, ext-json, PDO
plus a driver: pdo_mysql, pdo_pgsql or pdo_sqlite
Calling your AI provider, and talking to your database.
The ionCube loaderThe engine ships encoded, so the free loader has to be active. Without it, Banimark shows a page saying exactly what to install — the rest of your site keeps working. How to install it.
A database
MySQL 5.7+/8, MariaDB 10.4+, PostgreSQL 12+, or SQLite
Banimark keeps its own banimark_* tables. It never writes to yours.
ComposerHow the package is installed. Banimark is not on Packagist; each guide shows the one line that tells Composer where it lives.
HTTPS (strongly recommended)Chat transcripts and the signed visitor token travel over it.

No queue worker, no Redis, no Node build step, no cron job required.

The two shapes

How it ends up running

Inside a PHP app

Laravel gets a real package — service provider, migrations, artisan commands. Everything else PHP gets the standalone runtime: one file in your web root that serves the panel, the widget and the chat endpoint.

Laravel · Custom PHP · CodeIgniter

Beside a non-PHP app

A small PHP service on the same box, mounted under one path by your web server, so the widget stays same-origin. Your Node or Python app is not modified and does not depend on it. No PHP on the server at all? Bring it, or use Docker.

Node.js · Python · Docker

Something not covered?

Go, Rails, .NET, a stack nobody has heard of — if it serves HTML and you can add one location block to your web server, it works. Tell us what you are running.