import Link from "next/link"; import Image from "next/image"; import { getTranslations } from "next-intl/server"; import { Server, Database, Key, Palette, Globe, Settings, Cpu } from "lucide-react"; import DeepWikiIcon from "@/../public/deepwiki.svg"; import Context7Icon from "@/../public/context7.svg"; import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from "@/components/ui/table"; export const metadata = { title: "Self-Hosting Guide - prompts.chat", description: "Deploy your own prompts.chat instance with customizable branding, themes, and authentication", }; export default async function SelfHostingPage() { const t = await getTranslations("selfHosting"); return (

Self-Hosting Guide

Deploy your own prompts.chat instance with customizable branding, themes, and authentication.

{/* Features */}

What You Get

Curated prompt library with 100+ community-tested prompts
Custom branding, logos, and themes
Multiple auth providers (GitHub, Google, Azure, credentials)
AI-powered semantic search and generation (optional)
Multi-language support (11 locales)
CC0 licensed - use freely for any purpose

{/* Using Documentation AI-Agents */}

Using Documentation AI-Agents

{/* DeepWiki */}

DeepWiki

DeepWiki {" "}provides AI-powered documentation and insights for this repository.

AI-generated documentation from source code
Interactive codebase exploration
Architecture diagrams and component relationships
Available as an MCP server

{/* Context7 */}

Context7

Context7 {" "}is an AI-powered chat interface for exploring and understanding this repository.

Chat with the codebase using natural language
Get answers with code references
Understand implementation details quickly
Available as an MCP server

{/* Manually */}

Manually

{/* Prerequisites */}

Prerequisites

{t("prerequisites.nodeJs")}
{t("prerequisites.postgresql")}
{t("prerequisites.npm")}

{/* Recommended Database */}

Recommended Database

prompts.chat requires PostgreSQL. For a hosted database, we recommend{" "} Neon {" "}for serverless Postgres, connection pooling, and database branching.

Quick Start

# Clone the repository

git clone https://github.com/f/prompts.chat.git

cd prompts.chat

# Install dependencies

npm install

# Configure environment

cp .env.example .env

# Run migrations & seed

npm run db:migrate

npm run db:seed

# Start development server

npm run dev

{/* Environment Variables */}

Environment Variables

Create a .env file based on .env.example:

{/* Core Variables */}

Core (Required)

Variable Description DATABASE_URL PostgreSQL connection string. Add ?connection_limit=5&pool_timeout=10 for serverless. NEXTAUTH_URL Your app URL (e.g., http://localhost:3000) NEXTAUTH_SECRET Random secret for NextAuth session encryption

{/* OAuth Variables */}

OAuth Providers (Optional)

Variable Description GITHUB_CLIENT_ID GitHub OAuth App client ID GITHUB_CLIENT_SECRET GitHub OAuth App client secret GOOGLE_CLIENT_ID Google OAuth client ID GOOGLE_CLIENT_SECRET Google OAuth client secret AZURE_AD_CLIENT_ID Azure AD application client ID AZURE_AD_CLIENT_SECRET Azure AD application client secret AZURE_AD_TENANT_ID Azure AD tenant ID

{/* Storage Variables */}

Storage Providers (Optional)

Variable Description ENABLED_STORAGE url | s3 | do-spaces S3_BUCKET S3 bucket name S3_REGION S3 region (e.g., us-east-1) S3_ACCESS_KEY_ID S3 access key S3_SECRET_ACCESS_KEY S3 secret key S3_ENDPOINT Custom endpoint for S3-compatible services (MinIO, etc.) DO_SPACES_* DigitalOcean Spaces: BUCKET, REGION, ACCESS_KEY_ID, SECRET_ACCESS_KEY, CDN_ENDPOINT

{/* AI Variables */}

AI Features (Optional)

Variable Description OPENAI_API_KEY OpenAI API key for AI search and generation OPENAI_BASE_URL Custom base URL for OpenAI-compatible APIs OPENAI_EMBEDDING_MODEL Embedding model (default: text-embedding-3-small) OPENAI_GENERATIVE_MODEL Generative model (default: gpt-4o-mini)

{/* Analytics */}

Analytics (Optional)

Variable Description GOOGLE_ANALYTICS_ID Google Analytics measurement ID (e.g., G-XXXXXXXXX)

{/* Configuration */}

Configuration (prompts.config.ts)

Customize your instance by editing prompts.config.ts:

{/* Branding */}

Branding

Option Type Description name string Your app name displayed in header and footer logo string Path to logo for light mode logoDark string Path to logo for dark mode favicon string Path to favicon description string App description for SEO and homepage

{/* Theme */}

Theme

{/* Auth */}

Authentication

Option Values Description providers array credentials, github, google, azure allowRegistration boolean Allow public sign-up (credentials provider only)

{/* i18n */}

Internationalization

Option Type Description locales string[] Supported locales: en, tr, es, zh, ja, ar, pt, fr, it, de, ko defaultLocale string Default language

{/* Features */}

Features

Option Default Description privatePrompts true Allow users to create private prompts changeRequests true Enable version control with change requests categories true Enable prompt categories tags true Enable prompt tags aiSearch false AI-powered semantic search (requires OPENAI_API_KEY) aiGeneration false AI-powered generation features (requires OPENAI_API_KEY)

{/* White-label */}

White-Label Mode

Set useCloneBranding = true at the top of the config to:

Display your branding name and description on the homepage
Use your logo as the hero background watermark
Hide prompts.chat achievements (GitHub stars, Forbes, etc.)
Hide sponsor section and "Become a Sponsor" CTA
Hide "Clone on GitHub" button

{"// prompts.config.ts"}

const useCloneBranding = true;

{/* Production */}

Production Deployment

npm run build

npm run start

Deploy to Vercel, Railway, Render, or any Node.js hosting platform. Make sure to set all environment variables in your hosting provider's dashboard.

{/* Support */}

Support

For issues and questions, please open a{" "} GitHub Issue . For the complete documentation, see the{" "} SELF-HOSTING.md {" "}file in the repository.

); }