इंटलेयर को सेल्फ-होस्ट करना

इंटलेयर पूरी तरह से आपके अपने इंफ्रास्ट्रक्चर पर चल सकता है - इसके लिए इंटलेयर क्लाउड खाते की आवश्यकता नहीं है। एक ही कमांड एक उत्पादन-तैयार स्टैक को बूट करता है:

curl -fsSL https://intlayer.org/install.sh | sh

इंस्टॉलर एक docker-compose.yml और एक .env डाउनलोड करता है, आवश्यक सीक्रेट्स को स्वतः जेनरेट करता है, और docker compose up -d के साथ सभी कंटेनरों को शुरू करता है।

विषय-सूची

आर्किटेक्चर

                ┌─────────────────────────────┐ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐                └─────────────────────────────┘   │ VITE_BACKEND_URL                ┌─────────────────────────────┐   │                │  backend (Fastify/Bun)  :3100│ ◀─┘                └──────────────┬──────────────┘          ┌──────────┬─────────┼──────────┬───────────┐          ▼          ▼         ▼          ▼           ▼     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium     (1-node RS)             (S3 API)     (SMTP)        (in-image)                             minio:9001   mailpit:8025                             (console)    (web UI)

क्रोमियम (Puppeteer स्क्रीनशॉट जनरेशन के लिए उपयोग किया जाता है) बैकएंड इमेज के अंदर बंडल किया गया है - किसी अलग कंटेनर की आवश्यकता नहीं है।

पूर्व-आवश्यकताएँ

• डॉकर ≥ 24 और डॉकर कंपोज ≥ v2। यदि इनमें से कोई भी गायब है, तो इंस्टॉलर इंस्टॉल लिंक प्रिंट करता है और बाहर निकल जाता है।
• होस्ट पर पोर्ट 3000, 3100, 8025, 9000, और 9001 उपलब्ध होने चाहिए।
• एक Linux या macOS होस्ट (या Windows पर WSL2)।

त्वरित शुरुआत

curl -fsSL https://intlayer.org/install.sh | sh

इंस्टॉलर क्या करता है:

1. जांचता है कि docker और docker compose मौजूद हैं या नहीं।
2. docker-compose.yml और .env.example को ./intlayer/ में डाउनलोड करता है।
3. यदि कोई .env मौजूद नहीं है, तो उदाहरण कॉपी करता है और openssl rand के माध्यम से BETTER_AUTH_SECRET, S3_ACCESS_KEY_ID, और S3_SECRET_ACCESS_KEY के लिए रैंडम सीक्रेट्स जेनरेट करता है।
4. docker compose pull + docker compose up -d चलाता है।
5. URL प्रिंट करता है: डैशबोर्ड :3000, API :3100, ईमेल UI :8025, MinIO कंसोल :9001।

स्टैक के चालू होने के बाद, http://localhost:3000 खोलें और अपना पहला अकाउंट बनाएँ।

पहली बार सेटअप

एक नए instance (खाली डेटाबेस) पर, डैशबोर्ड खोलने से आप /init पृष्ठ पर रीडायरेक्ट हो जाते हैं:

1. पहला खाता बनाएँ। क्योंकि users collection खाली है, यह खाता स्वचालित रूप से super admin को प्रचारित किया जाता है।
2. एक सत्यापन ईमेल भेजा जाता है (Resend के माध्यम से)। ईमेल सत्यापन अनिवार्य है — यही कारण है कि RESEND_API_KEY को शुरू करने से पहले सेट किया जाना चाहिए।
3. ईमेल में लिंक पर क्लिक करें, फिर साइन इन करें।

एक बार admin मौजूद हो जाने पर, /init मानक साइन-इन पृष्ठ पर रीडायरेक्ट करता है।

सेवाएँ

आंतरिक पोर्ट (mongo, redis) डिफ़ॉल्ट रूप से होस्ट पर एक्सपोज़ नहीं किए जाते हैं।

MinIO पोर्ट 9000 ब्राउज़र द्वारा पहुँच योग्य होना चाहिए क्योंकि अपलोड किए गए एसेट (अवतार, स्क्रीनशॉट) सीधे S3_PUBLIC_URL=http://localhost:9000/intlayer से लोड होते हैं।

Environment variables

आवश्यक

आवश्यक (स्वतः जेनरेटेड या प्रॉम्प्टेड)

Optional (features degrade gracefully when absent)

वैकल्पिक (अनुपस्थिति में फीचर धीरे-धीरे खराब हो जाते हैं)

अपने इंटलेयर प्रोजेक्ट को कनेक्ट करना

एक बार जब स्टैक चल रहा हो, तो अपने प्रोजेक्ट को intlayer.org के बजाय सेल्फ-होस्टेड बैकएंड और डैशबोर्ड पर पॉइंट करें।

प्रोजेक्ट कॉन्फ़िगरेशन

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,

    /**
     * सेल्फ-होस्टेड CMS डैशबोर्ड का URL।
     * डिफ़ॉल्ट: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // उदाहरण के लिए http://localhost:3000

    /**
     * सेल्फ-होस्टेड बैकएंड API का URL।
     * डिफ़ॉल्ट: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // उदाहरण के लिए http://localhost:3100
  },
};

export default config;

अपने प्रोजेक्ट के .env में एनवायरनमेंट वेरिएबल सेट करें:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_CLIENT_ID=<your-client-id>INTLAYER_CLIENT_SECRET=<your-client-secret>

अपने सेल्फ-होस्टेड डैशबोर्ड में http://localhost:3000/projects पर प्रोजेक्ट्स → एक्सेस कीज़ के अंतर्गत एक्सेस क्रेडेंशियल बनाएँ।

@intlayer/api SDK

प्रोग्रामेटिक रूप से @intlayer/api SDK का उपयोग करते समय, backendURL को स्पष्ट रूप से पास करें:

import { createIntlayerCMS } from "@intlayer/api";import { dictionaryEndpoint } from "@intlayer/api/dictionary";const cms = createIntlayerCMS({  editor: {    clientId: process.env.INTLAYER_CLIENT_ID,    clientSecret: process.env.INTLAYER_CLIENT_SECRET,    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100  },});const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();

अपग्रेड करना

मौजूदा डिप्लॉयमेंट पर इंस्टॉलर को फिर से चलाने से रोलिंग अपग्रेड होता है:

curl -fsSL https://intlayer.org/install.sh | sh

यह नवीनतम इमेज को खींचता है और docker compose pull && docker compose up -d के साथ कंटेनरों को रीस्टार्ट करता है। मौजूदा वॉल्यूम (mongo-data, redis-data, minio-data) संरक्षित रहते हैं - कोई डेटा हानि नहीं होती है।

./intlayer/ डायरेक्टरी के अंदर से मैन्युअल रूप से अपग्रेड करने के लिए:

docker compose pulldocker compose up -d

बैकअप और रीस्टोर

सभी स्थायी डेटा तीन नामित डॉकर वॉल्यूम में रहते हैं।

बैकअप

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/mongo-data.tar.gz /datadocker run --rm \  -v intlayer_redis-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/redis-data.tar.gz /datadocker run --rm \  -v intlayer_minio-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/minio-data.tar.gz /data

रीस्टोर

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar xzf /backup/mongo-data.tar.gz -C /# redis-data और minio-data के लिए दोहराएँ

सीमाएं

• MongoDB बाहरी (Atlas) होना चाहिए। बैकएंड केवल mongodb+srv:// पर कनेक्ट करता है (जो DB_ID / DB_MDP / DB_CLUSTER से बनाया गया है), इसलिए एक सादा mongodb://host:27017 — कंटेनर के अपने बंडल किए गए mongod सहित — का उपयोग नहीं किया जा सकता है। एक MongoDB Atlas क्लस्टर प्रदान करें।
• कोई कस्टम डोमेन नहीं। सभी ब्राउज़र-सामने वाले VITE_* URLs बिल्ड टाइम पर ऐप में इनलाइन किए जाते हैं, और प्रकाशित इमेज localhost मानों के साथ आती है। डैशबोर्ड को http://localhost:3000 पर एक्सेस किया जाना चाहिए; इसे एक सार्वजनिक डोमेन पर सर्व करने के लिए इमेज को लक्ष्य URLs के साथत: फिर से बनाने की आवश्यकता होगी और इसे तुरंत समर्थित नहीं किया जाता है।
• ईमेल को एक काम करने वाले मेलर की आवश्यकता है। पहली बार सेटअप ईमेल सत्यापन को लागू करता है, इसलिए या तो RESEND_API_KEY या एक global SMTP mailer (MAIL_PROVIDER=smtp + MAIL_SMTP_*) को कॉन्फ़िगर किया जाना चाहिए। पहले एडमिन साइन इन करने के बाद, प्रत्येक संगठन डैशबोर्ड से अपना स्वयं का SMTP या Resend मेलर भी कॉन्फ़िगर कर सकता है।

समस्या निवारण

पहली शुरुआत में बैकएंड क्रैश-लूप करता है

बैकएंड शुरू होने से पहले MongoDB और Redis स्वस्थ होने चाहिए। कंपोज़ फ़ाइल condition: service_healthy के साथ depends_on का उपयोग करती है। यदि आप बार-बार बैकएंड रीस्टार्ट देखते हैं, तो जांचें कि mongo और redis हेल्थचेक पास हो गए हैं या नहीं:

docker compose psdocker compose logs mongodocker compose logs redis

ईमेल नहीं भेजा जा रहा है

डिफ़ॉल्ट रूप से, सभी आउटबाउंड ईमेल मेलपिट द्वारा कैप्चर किए जाते हैं। भेजे गए संदेशों को देखने के लिए http://localhost:8025 खोलें। वास्तविक ईमेल भेजने के लिए, .env में MAIL_PROVIDER=resend और RESEND_API_KEY=<your-key> सेट करें, फिर बैकएंड को रीस्टार्ट करें:

docker compose restart backend

MinIO बकेट गायब है

यदि minio-init वन-शॉट सर्विस नहीं चली (या MinIO के तैयार होने से पहले चली), तो बकेट को मैन्युअल रूप से बनाएँ:

docker compose run --rm minio-init

उपयोगी लिंक

• इंटलेयर सीएमएस डॉक्यूमेंटेशन
• कॉन्फ़िगरेशन संदर्भ
• सीएमएस SDK — @intlayer/api
• Docker Image (aymercizip/intlayer-selfhost)