Tenelix
Documentation

Quickstart

Set up a Tenelix instance for evaluation in under 30 minutes.

This guide walks you through setting up a local Tenelix instance for evaluation. For production deployment, see Cloud deployment or Self-hosted deployment.

Prerequisites

  • PHP 8.2+ with pdo_pgsql, pgsql, mbstring, openssl, xml
  • Composer 2.x
  • Node.js 18+ and npm
  • PostgreSQL 15+ with a superuser account

Installation

Clone the platform repository and run the setup script:

git clone https://github.com/tenelix/tenelix-cloud.git
cd tenelix-cloud
./scripts/setup.sh

The setup script installs PHP and Node dependencies, creates .env from .env.example, and builds frontend assets.

Database setup

Run the database reset script — it creates the user, both databases (tenelix_cloud and tenelix_tenants_shared), and seeds reference data:

./scripts/db-reset.sh

Pass --no-demo to skip the sample tenant.

Start the dev servers

# Terminal 1 — Laravel
php artisan serve

# Terminal 2 — Vite (hot reload)
npm run dev

Visit http://localhost:8000 for the central app, or http://demo.localhost:8000 for the demo tenant.

Default demo credentials: admin@demo.tenelix.test / password.