Install Korieo Community

Requirements

• Node.js: 20 LTS or newer for local Community evaluation.
• Package manager: npm, using the committed package-lock.json files.
• Database: PostgreSQL, configured through DATABASE_URL.
• GitHub token plus GITHUB_OWNER and GITHUB_REPO: optional, required only when evaluating GitHub integration workflows.

Clone or download the project

Use the approved Community distribution path for your team. If you clone from GitHub, confirm that you are using the intended branch and review the project README before running commands.

Configure environment variables

Create a local environment file from the project template if one is provided. Keep secrets out of source control and fill in values for the services you plan to evaluate.

Install dependencies

Install dependencies with the package manager specified by the project. If multiple package managers are present, use the one documented by the Community release notes or README.

Run locally

Start the local development server with the documented command. Keep the terminal open so runtime errors, missing variables, or database connection issues are visible during setup.

Confirm setup

• Open the local app URL and confirm the application loads.
• Confirm authentication or workspace setup behaves as expected for the configured mode.
• Create or inspect a Product Truth to verify core product context is available.
• If GitHub is configured, confirm repository connection status before relying on delivery signals.

Common install errors

• Missing runtime version: install Node.js 20 LTS or newer before reinstalling dependencies.
• Package manager mismatch: remove generated lockfiles that do not belong to the selected package manager before reinstalling.
• Database connection failed: verify DATABASE_URL, database availability, and required migrations.
• Authentication callback failed: verify NEXT_PUBLIC_APP_URL, Supabase public auth variables, and any configured redirect origins.