Installation

Get Cainty running on your server in minutes.

Requirements

RequirementMinimum Version
PHP8.2+
DatabaseSQLite 3 (default) or MySQL/MariaDB 5.7+
Web ServerApache with mod_rewrite
PHP ExtensionsPDO, mbstring, json, curl

Step 1: Download

Clone the repository or download the latest release:

git clone https://github.com/alekblom/cainty.git
cd cainty

Step 2: Configure

Copy the example configuration file:

cp .env.example .env

Edit .env with your settings. At minimum, set:

  • APP_URL — Your site's full URL (e.g., https://yourdomain.com)
  • APP_SECRET — A random 64-character string for session security
  • DB_DRIVERsqlite (default) or mysql

Step 3: Set Permissions

Ensure the storage directory is writable:

chmod -R 775 storage/
chown -R www-data:www-data storage/

Step 4: Web Installer

Point your browser to https://yourdomain.com/install.php. The installer will:

  1. Check system requirements
  2. Configure the database
  3. Create your admin account
  4. Set up the site name and settings

Step 5: Apache Configuration

Cainty includes an .htaccess file in the public/ directory. Make sure your virtual host points to the public/ directory:

<VirtualHost *:443>
    ServerName yourdomain.com
    DocumentRoot /var/www/cainty/public

    <Directory /var/www/cainty/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Post-Install

After installation:

  • Delete or rename public/install.php for security
  • Log in to /admin to start creating content
  • Configure your LLM API keys in Admin > Settings > LLM Keys to use AI agents