First Time Setup

This guide walks you through getting Drako Tickets running for the first time.

Prerequisites

• Node.js 18 or later

• A Supabase project (free tier is fine)

• A hosting provider (Vercel recommended) or a self-hosted server

1

Install dependencies

Open a terminal in the project folder and run:

npm install

2

Create your environment file

The project includes a .env.local.example file with every available variable and a description of each. Create a copy and call it .env

Rename the .env.example to .env

Open .env in a text editor. The sections below explain where to find each value.

Supabase credentials

These are required for the app to connect to your database and auth service.

Variable	Where to find it
NEXT_PUBLIC_SUPABASE_URL	Supabase dashboard → Select the Project → Copy the Project URL under "x's Project"
NEXT_PUBLIC_SUPABASE_ANON_KEY	Project Settings → API Keys → Legacy anon → Copy anon public
SUPABASE_SERVICE_ROLE_KEY	Project Settings → API Keys → Legacy anon → Copy service_role
DATABASE_URL	Project Overview → Connect (Top of Page) → Connection String → Change method to 'Transaction pooler' → Copy database link

You can view your project by navigating to https://supabase.com/dashboard/org

Your DATABASE_URL will look like

postgresql://postgres.xxx:[YOUR-PASSWORD]@aws-1-eu-west-1.pooler.supabase.com:6543/postgres

App URL

These three variables tell the app what URL it is running on. They are used to build absolute URLs for outbound emails, OAuth redirect callbacks, and the IMAP poller.

Production (example):

APP_PROTOCOL=https
APP_HOST=your-app.vercel.app
APP_PORT=443

Local development:

APP_PROTOCOL=http
APP_HOST=localhost
APP_PORT=3000

3

Configure Supabase Auth

Before running the app, set the allowed URLs in your Supabase project so that OAuth and email callbacks work correctly.

1. Go to your Supabase dashboard → Authentication → URL Configuration.

2. Set Site URL to your app's URL, e.g. https://your-app.vercel.app.

3. Under Redirect URLs, add:

   • https://your-app.vercel.app/auth/callback

   • http://localhost:3000/auth/callback (for local development)

4

Run the application

npm run start

On first boot the application will automatically:

1. Run all pending database migrations

2. Create a default admin account

Default admin credentials:

Email:    [email protected]
Password: password123

Important: Log in immediately and change the admin password. You will be prompted to set the email and password

Next steps

• Email Integration — set up SMTP outbound mail and IMAP inbound email-to-ticket

• Discord Integration — connect the Discord bot to your server

• Login Providers — enable Google, Discord, or Microsoft OAuth sign-in