Setup guide

Installation

Use this page to prepare hosting, upload the buyer package, configure the database, and complete the browser installer.

Requirements

Server

  • PHP 8.2 or newer.
  • Apache or Nginx.
  • Document root should point to public/.
  • MySQL 5.7+, MariaDB 10.4+, or SQLite for local testing.
  • Writable storage/, bootstrap/cache/, database/, and public/.

PHP Extensions

  • OpenSSL, PDO, PDO MySQL, Mbstring, Tokenizer, Ctype, JSON, and Fileinfo.
  • GD for image transforms and template thumbnails.
  • IMAP for Email module inbox connection checks.
  • cURL and Zip are recommended for common shared hosting tasks.

Optional Build Tools

  • The buyer package includes Composer dependencies so the browser installer can boot after upload.
  • Composer 2.x is useful when refreshing PHP dependencies.
  • Node.js 20.19+ or 22.12+ and npm are only needed when rebuilding Vite assets.
  • Terminal access is helpful for manual cache, migration, and storage commands, but the normal install flow is browser based.

Browser

  • Current Chrome, Edge, Firefox, or Safari.
  • JavaScript enabled for the admin UI and Visual Builder.
  • Cookies enabled for authenticated sessions.

Fresh Install

Upload And Open Installer

unzip yunikengine.zip
upload files to hosting
open https://your-domain.com/install

The release package includes vendor/ and compiled assets. On the first browser request, YunikEngine copies .env.example to .env and creates a unique APP_KEY if one is missing. Use the installer form to enter database details, site name, administrator details, and demo content choices.

Permissions

chmod -R 775 storage bootstrap/cache
chmod -R 775 public/template-thumbnails
chmod -R 775 database

On shared hosting, use the permission level recommended by the host. Avoid world-writable permissions unless the host requires them.

Browser Installer

Checks

The installer checks PHP version, required extensions, and writable folders before installation.

Database

The installer can configure MySQL or create a local SQLite database for testing.

Admin Account

The installer creates the first administrator and signs the user into the Control Center.

Starter Content

Optional demos include starter pages, top-tier templates, blog posts, and email templates. Demo text is marketplace-safe Lorem Ipsum style content.

Manual Commands

When Browser Migrations Are Blocked

php artisan migrate --force
php artisan db:seed --force
php artisan storage:link
php artisan optimize:clear