Quick start

The fastest way to try Huddle is with Docker. A browser-based setup wizard handles the database and admin account.

Docker (recommended)

git clone https://github.com/AllanGallop/Huddle.git
cd Huddle
docker compose -f DockerCompose.yaml up --build

Open http://localhost:8000. When the installer asks for a database host, use db.

For day-to-day development (keeps your .env and database between restarts):

docker compose -f DockerCompose.dev.yaml up --build

See Docker for fresh-install scripts and troubleshooting.

Local development (without Docker)

cd huddle
composer config http-basic.composer.fluxui.dev <username> <license-key>
composer install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate
npm install
npm run build
composer run dev

Flux UI is a licensed Livewire component library — Composer authentication is required before composer install.

After install

1. Complete the setup wizard at /setup.php (or let Docker redirect you there on first run)
2. Log in with the admin account you created
3. Explore the dashboard, create a project, or publish an event

Next: Hosting for production deployment.