Hosting

Deploy Huddle on any server with PHP 8.2+, Apache (recommended), and SQLite or MySQL/MariaDB.

Requirements

Component	Version
PHP	8.2+ (8.4 recommended)
Database	SQLite, MySQL, or MariaDB
Web server	Apache with mod_rewrite

Required extensions: pdo, mbstring, openssl, tokenizer, xml, ctype, json, fileinfo, curl, gd, intl

Document root

Point the web server at huddle/public/, not the repository root.

/var/www/huddle/huddle/public/   ← document root

Only public/ should be web-accessible.

Web installer

1. Upload files (or use a deployment build)
2. Ensure storage/, bootstrap/cache/, and database/ are writable
3. Copy setup htaccess if this is a fresh install:

cp public/.htaccess.setup public/.htaccess

4. Visit https://your-domain.example/setup.php
5. Complete requirements, database, and admin steps

Production .env

APP_ENV=production
APP_DEBUG=false
APP_URL=https://your-domain.example

MAIL_MAILER=smtp
# ... mail settings ...

GDPR_CONTROLLER_NAME="Your Organization"
GDPR_CONTACT_EMAIL=privacy@your-domain.example

Cron and queue

* * * * * cd /path/to/huddle && php artisan schedule:run >> /dev/null 2>&1

Run a queue worker for emails and background jobs:

php artisan queue:work

Updates

php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

Restart queue workers after deploying code changes.