Eigen Hosting LightCMS
ImplementerenHandleiding voor zelf-host LightCMS, het omvat de GitHub App, PostgreSQL, omgevingsvariabelen, optionele AI, CDN en e-mail en het implementeren naar randen.
Wilt u LightCMS volledig onder uw controle? LightCMS is een SvelteKit applicatie, zodat het overal kan worden geïmplementeerd, ondersteund door een PostgreSQL database en een GitHub App (oktober. Uw inhoud laat nooit uw eigen GitHub repositories over.
Deze handleiding leidt je door alles wat je nodig hebt om je eigen installatie te draaien: het maken van de GitHub App, provisioning PostgreSQL, het configureren van omgevingsvariabelen en het implementeren.
Hoe de stukjes samen passen
| Onderdeel | Doel | vereist |
|---|---|---|
| PostgreSQL | Opslaat gebruikers, sessies, toegangscodes en GitHub installaties | ja |
| GitHub App | Leest en schrijft inhoud in je repositories en verbindt gebruikers met GitHub | ja |
| SMTP provider | Verstuurt magic-link inlog e-mails | Ja, voor magic-link aanmelden |
| OpenAI-compatibele API | Behoudt de AI Copilot | Optioneel |
| Spraak-naar-tekst API | Posters spraakdictatie | Optioneel |
| CDN afbeelding | Afbeeldingen van hosts geüpload in de editor | Optioneel |
| Postvakje | Product analytics en AI waarneming | Alleen vereist in ontwikkeling |
Vereisten
- mise: installeert en beheert taken afhankelijkheden. Deze handleiding veronderstelt dat je hem hebt geïnstalleerd.
- PostgreSQL: een database die TLS-verbindingen accepteert. Cloud providers zoals Neon, Supabase of Nile werken goed. Zie coole free postgres voor gratis opties.
- GitHub account: nodig om de GitHub App te registreren.
- SMTP provider (voor magische links): Als u een domein heeft, opnieuw verzenden is een goede optie. Anders, gebruik Zoho Mail en maak een app-wachtwoord aan.
TLS is verplicht. Het programma verbindt met PostgreSQL met
ssl: "require". Een lokale PostgreSQL instantie zonder TLS ingeschakeld zal worden geweigerd, dus gebruik een gehoste database of configureer TLS op uw eigen server.
1. Fork de repository en installeer afhankelijkheden
Kloon de repository en installeer dependencies:
cd lightcms
mise trust
mise deps
mise run install2. Create the GitHub App
LightCMS gebruikt een GitHub App voor twee dingen: gebruikers ondertekenen met GitHub (OAuth) en namens u handelen namens via installaties. Je kunt het maken met de ingebouwde Probot setup wizard, of met de hand.
Optie A: Probot installatiewizard
start de bot met:
mise run botZonder inloggegevens in .env, start Probot een setup server op http://localhost:3000:
- Open
http://localhost:3000en klik op Registreer GitHub App. - Kies uw persoonlijke account of een organisatie.
- Bevestigen. Probot maakt de app en schrijft de inloggegevens naar je
.envbestand.
De wizard stelt de webhook URL in op een Smee kanaal (of http://localhost:3000/), niet op LightCMS webhook eindpunt. Werk het bij in de GitHub App instellingen voordat u live gaat (Zie Production deployment).
Optie B: Handmatige installatie
Maak de app in GitHub instellingen → Ontwikkelaarsinstellingen → GitHub Apps → Nieuwe GitHub App met deze waarden:
| Instellingen | Waarde |
|---|---|
| Startpagina URL | https://<your-domain> |
| Callback URL | https://<your-domain>/api/auth/callback/github |
| Setup URL | https://<your-domain>/github/setup |
| Webhook URL | https://<your-domain>/api/github/webhook |
| Webhook geheim | Een willekeurig geheim (zie geheimen genereren) |
Repository rechten
| Bevoegdheden | Toegangsrechten | Gebruikt voor |
|---|---|---|
Inhoud |
Lezen en schrijven | Inhoudsbestanden lezen en uitvoeren |
Kwesties |
Lezen en schrijven | Bekijk opmerkingen en labels op pull requests |
Pull requests |
Alleen-lezen | Aanbieding van de bestanden gewijzigd in een pull-aanvraag |
Vastleggen statussen |
Lezen en schrijven | Rapporteer content validatie bij pushes |
Metagegevens |
Alleen-lezen | Verplicht voor elke GitHub App |
Abonneer je op gebeurtenissen: Duw en Pomp verzoek. Activiteiten van de installatie worden automatisch geleverd in GitHub apps.
Na het aanmaken van de app, noteer de App ID, genereer een client secret, en download een persoonlijke sleutel (. </code> ).
3. Configureer omgevingsvariabelen
Maak een .env bestand aan in de projectroot. De repository verzendt geen bruikbaar voorbeeldbestand, dus gebruik de referentie hieronder.
vereist
# ---------------------------------------------------------------------------
# Authenticatie (Better Auth)
# ---------------------------------------------------------------------------
BETTER_AUTH_SECRET="<output of: openssl rand -hex 32>"
# Publieke URL van deze instantie. Moet overeenkomen met de URL-gebruikers bezoeken.
BETTER_AUTH_URL="http://localhost:5173"
# ---------------------------------------------------------------------------
# Database (PostgreSQL, TLS vereist)
# -----------------------------------------------------------------------------------------------------------
DATABASE_URL="postgresql://user:password@host:5432/lightcms? slmode=require"
# -------------------------------------------------------------------------------------------
# GitHub App
# -----------------------------------------------------------------------------------------------------------
GITHUB_APP_ID="123456"
GITHUB_CLIENT_ID="Iv1. xxxxxxxxx"
GITHUB_CLIENT_SECRET="<github-app-client-secret>"
GITHUB_WEBHOOK_SECRET="<webhook-secret>"
GITHUB_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----"GITHUB_PRIVATE_KEY is de volledige PEM inhoud. Houd de regeleinden en omhullen de waarde in dubbele aanhalingstekens, dat is hoe de Probot wizard het schrijft.
Vereist voor ontwikkeling
LightCMS rapporteert analytics en fouten naar PostHog. Als de sleutels ontbreken, gooit de app ontwikkeling om te voorkomen dat events stilletjes worden laten vallen. In de productie zijn ze optioneel, en telemetrie wordt overgeslagen wanneer ze niet zijn ingesteld.
VITE_POSTHOG_PROJECT_TOKEN="phc_xxxxxxxxxxxx"
VITE_POSTHOG_HOST="https://us.i.posthog.com"E-mail: vereist voor magic-link aanmelding
Magische links worden verzonden via SMTP met Nodemailer. Het verzenden mislukt met een configuratiefout wanneer MAIL_HOST, MAIL_USER, MAIL_PASS of MAIL_FROM ontbreken.
MAIL_HOST="smtp.resend.com"
# Standaard ingesteld op 587 wanneer
MAIL_PORT="465"
# "true", "1", "yes" of "aan" maakt impliciet TLS mogelijk. Als weggelaten wordt, is TLS alleen ingeschakeld voor poort 465.
MAIL_SECURE="1"
MAIL_USER="resend"
MAIL_PASS="<smtp-password-or-api-key>"
MAIL_FROM="LightCMS <[email protected]>"Optioneel: AI Copilot
De Copilot gebruikt elke OpenAI-compatibele chat completions API. Alle drie de variabelen zijn nodig om het te laten werken.
OPEN_AI_ENDPOINT="https://api.openai.com/v1"
OPEN_AI_APIKEY="sk-..."
OPEN_AI_MODEL="gpt-4o-mini"Elke provider die een OpenAI-compatibele API laat zien, bijvoorbeeld OpenAI, OpenRouter (https://openrouter. i/api/v1) of NVIDIA NIM.
Optioneel: speech-to-text dictatie
LightCMS ondersteunt twee backends van transcriptie. Als beide zijn geconfigureerd, wordt de OpenAI-compatibele backend gebruikt.
OpenAI-compatibele transcriptie. Het is geselecteerd wanneer SPEECH_API_KEY is ingesteld, en heeft ook SPEECH_MODEL nodig :
SPEECH_API_KEY="<api-key>"
SPEECH_MODEL="fluister-1"
# basis-URL van de provider. Laat het weg om de OpenAI-standaard te gebruiken.
SPEECH_ENDPOINT="https://api.openai.com/v1"Punt SPEECH_ENDPOINT bij elke provider die de /audio/transcripties API implementeert. en zet SPEECH_MODEL naar een model dat aanbiedt. Een trailing /audio/transcripties in het eindpunt wordt automatisch verwijderd.
Wit.ai wordt gebruikt wanneer SPEECH_API_KEY niet is ingesteld:
WIT_AI_TOKEN="<wit-ai-server-access-token>"Als geen van beide is geconfigureerd, is dictatie niet beschikbaar.
Optioneel: afbeelding uploaden (CDN)
Afbeeldingen in de editor worden verzonden naar een Chevereto-compatibele upload API. De gehoste opties omvatten FreeImage.host en ImgBB, of u kunt uw eigen Chevereto bijvoorbeeld uitvoeren .
CDN_URL="https://freeimage.host/api/1/upload"
CDN_KEY="<cdn-api-key>CDN_KEY wordt verzonden als de key query parameter tenzij CDN_URL al een bevat. Als de upload mislukt of de variabelen zijn vrijgegeven LightCMS valt terug naar het insluiten van de afbeelding in het document als base64 gegevens: URL. Dit werkt maar het maakt uw Markdown bestanden veel groter, dus configureer een CDN voor echt gebruik.
Lokale Webhook doorsturen (alleen ontwikkeling)
WEBHOOK_PROXY_URL="https://smee.io/<your-channel>"Dit wordt gelezen door Probot, niet door de SvelteKit app. Zie Testen van lokale webhooks.
Geheimen genereren
Gebruik een van deze om BETTER_AUTH_SECRET en GITHUB_WEBHOOK_SECRET te genereren:
openssl rand -hex 32
# of
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"4. De database instellen
LightCMS gebruikt Drizzle ORM. Het schema leeft in src/lib/server/db/schema.ts, en migraties worden gegenereerd in de map drizzle. Met DATABASE_URL ingesteld, pas de migratie toe:
bun run db:migrerenTijdens de lokale ontwikkeling kun je het schema rechtstreeks naar de database pushen, zonder migratiebestanden:
bun run db:pushAndere database scripts:
| Opdracht | Beschrijving |
|---|---|
bun run db:genereren |
Een migratie genereren na het bewerken van het schema |
bun run db:studio |
Blader en bewerk uw gegevens in Drizzle Studio |
5. Lokaal uitvoeren
bun run dev

LightCMS is nu beschikbaar op http://localhost:5173. Stel BETTER_AUTH_URL in op dit adres en log voor de eerste keer in met GitHub
Webhooks lokaal testen
GitHub kan webhooks niet leveren aan localhost, dus stuur ze door via smee.io:
Maak een kanaal aan op smee.io en kopieer de URL ervan.
Zet
WEBHOOK_PROXY_URLin.envnaar die URL.Zet de Webhook URL in je GitHub App instellingen op dezelfde URL.
Voer de bot uit in een tweede terminal:
bun run bot:start
De bot registreert dezelfde handlers als het productie eindpunt: inhoudsvalidatie op push, review commentaren en labels op pull_request, en installatie loggen.
6. Productie implementatie
Het project is geconfigureerd met SvelteKit, wat een leverancier is. Vercel, Netlify en Cloudflare Workers worden allemaal ondersteunde implementatiedoelen uit de doos.
- Importeer je Git repository naar implementatieplatform.
- Voeg elke omgevingsvariabele toe van stap 3 in Projectinstellingen → Omgeving Variabelen. Zet
BETTER_AUTH_URLop uw productie URL. - Implementeren.
Om de productie versie lokaal te verifiëren:
bun run build
bun run voorbeeldProbleemoplossing
Make a account with Wit.ai it's a free service by meta | And any openai compatible API for transcription. · Men kan groq of assemblyai of Lv. Elevenlabs of deepgram of sarvam gebruiken. |
Referenties PostHog Referenties
Gebruik het project token van je eigen PostHog project (Project instellingen → Project API). Gebruik geen token uit deze documentatie: gebeurtenissen die zijn verzonden met een gedeeld land in het project van iemand anders dus zijn inzichten, waarschuwingen en meldingen zijn niet van jou om te lezen.
VITE_POSTHOG_PROJECT_TOKEN=phc_your_project_token
VITE_POSTHOG_HOST=https://us.i.posthog.com
WIT_AI_TOKEN="Toegangstoken"
WIT_AI_CLIENT_TOKEN="Client access token"APP_ID=
BETTER_AUTH_SECRET=
BETTER_AUTH_URL=
CDN_KEY=
CDN_URL=
DATABASE_URL=
GITHUB_APP_ID=
GITHUB_APP_NAME=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_PRIVATE_KEY=
GITHUB_WEBHOOK_SECRET=
MAIL_FROM=
MAIL_HOST=
MAIL_PASS=
MAIL_PORT=
MAIL_SECURE=
MAIL_USER=
OPEN_AI_ENDPOINT=
OPEN_AI_MODEL=
OPEN_AI_APIKEY=
ORIGIN=
PRIVATE_KEY=
VITE_POSTHOG_HOST=
VITE_POSTHOG_PROJECT_TOKEN=
SPEECH_API_KEY=
SPEECH_ENDPOINT=
SPEECH_MODEL=
WEBHOOK_SECRET=
WIT_AI_CLIENT_TOKEN=
WIT_AI_TOKEN=