Server Requirements

PHP 8.2+ with extensions: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath, Fileinfo, GD or Imagick.
Database: MySQL 8+ or MariaDB 10.5+.
Web Server: Apache or Nginx.
Composer to manage PHP packages.
Node.js 18+ with NPM to build interface via Vite.
FFmpeg recommended for video clip generation.

Preparation

Create a new database and remember DB_DATABASE, DB_USERNAME, and DB_PASSWORD.
Upload project files to hosting. The web root must point to the public/ folder.

⚠️

If you cannot set the root to public/ on shared hosting, use a subdomain pointing to public/ or create an .htaccess file in the root to redirect to public/index.php.

Installation Steps

Copy .env.example file to .env then update basic values (Site URL, Database, Mail).
Ensure the root is set to public/ on the web server.
Complete setup via the Installation Wizard explained below.

ℹ️

Development and production environments must match in major tool versions (PHP and Node) to ensure build stability.

Installation Wizard

Kudo provides a visual installation wizard at path /install which checks requirements, sets up the database, creates the system admin, then the EKR License step. Follow the displayed instructions to complete the setup.

Installation Video Guide

Watch the following visual guide to learn how to install Kudo step-by-step, starting from uploading files to activating the license.

In case of embed error (like code 153), you can watch the video directly on YouTube via this link: https://youtu.be/nhQPLzwU91w

Check requirements.
Configure database connection and write values into .env.
Create Admin account.
Activate license via EKR and bind domain.

✅

After successful wizard completion, an installation marker file .install is created in the project root.

Permissions

Make storage/ and bootstrap/cache/ writable by PHP.
Ensure file upload is enabled with appropriate size in PHP settings (upload_max_filesize, post_max_size).

Server Setup

Point the site root to public/ folder and ensure Rewrite is enabled. Provide an SSL certificate for production environment.

Queues & Scheduled Tasks

Enable background queue worker service on the server.
Set up a scheduled task to run system scheduling periodically (every minute).