Skip to main content
Step 2
Install

Install

Install dependencies and set up your development environment

Prerequisites

Before you begin, make sure you have the following installed on your system:

Verify your development environment
# Check Node.js version (18+ required)
node --version

# Check npm version
npm --version

# Check Git version
git --version

Installation Steps

Follow these steps to get Boiler.click running on your machine:

Complete installation process
# 1. Clone the repository
git clone https://github.com/ralphdp/boiler.git
cd boiler

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.example .env.local

# 4. Start the development server
npm run dev

Environment Variables

Configure your environment variables for proper functionality:

Complete environment variables configuration
# Maintenance Mode
MAINTENANCE_MODE=false

NEXT_PUBLIC_VERSION="0.0.1"
NEXT_PUBLIC_BUILD_TIME="Oct. 25, 2025"

# Brand
NEXT_PUBLIC_SITE_TITLE="Boiler.click"
NEXT_PUBLIC_SITE_EMAIL_SUPPORT="hi@boiler.click"
NEXT_PUBLIC_SITE_PHYSICAL_ADDRESS="123 Oak St."
NEXT_PUBLIC_SITE_TELEPHONE="+18885551234"
NEXT_PUBLIC_SOCIAL_GITHUB=""
NEXT_PUBLIC_SOCIAL_X=""
NEXT_PUBLIC_SOCIAL_FACEBOOK=""
NEXT_PUBLIC_SOCIAL_YOUTUBE=""
NEXT_PUBLIC_GA_ID="G-XXXXXXXXXX"

# Database Connections
# Database
DATABASE_URL="postgresql://username:password@localhost:5432/boiler"
# DATABASE_URL="postgresql://neondb_owner:neondb_password@ep-polished-band-adiag2vf-pooler.c-2.us-east-1.aws.neon.tech/boiler?sslmode=require"
REDIS_URL="redis://localhost:6379"
# REDIS_URL="redis://default:password@redis-18324.c323.us-east-1-2.ec2.redns.redis-cloud.com:18324"

# Authentication & Security
# JWT Secret for token signing (if using JWT auth)
JWT_SECRET=""

# Session Configuration
SESSION_SECRET=""

# Third-Party Services
# OAuth Providers
GOOGLE_CLIENT_ID=602141741836-[id].apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=""
GITHUB_CLIENT_ID=""
GITHUB_CLIENT_SECRET=""
DISCORD_CLIENT_ID="your-discord-client-id"
DISCORD_CLIENT_SECRET="your-discord-client-secret"
FACEBOOK_CLIENT_ID="your-facebook-client-id"
FACEBOOK_CLIENT_SECRET="your-facebook-client-secret"
TWITTER_CLIENT_ID="your-twitter-client-id"
TWITTER_CLIENT_SECRET="your-twitter-client-secret"
# Payment Processing
STRIPE_PUBLISHABLE_KEY="pk_test_your-stripe-publishable-key"
STRIPE_SECRET_KEY="sk_test_your-stripe-secret-key"
STRIPE_WEBHOOK_SECRET="whsec_your-webhook-secret"

# Email
SMTP_HOST="smtp.example.com"
SMTP_PORT="587"
SMTP_USER=""
SMTP_PASS=""