Agent skill

Cometchat Self Host

by cometchat in cometchat/cometchat-skills

Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted…

MITAuto-check passedDevOps & Cloud

Install Cometchat Self Host

skills CLI
$ npx skills add cometchat/cometchat-skills --skill cometchat-self-host -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cometchat/cometchat-skills cometchat-self-host --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cometchat/cometchat-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cometchat-self-host .claude/skills/cometchat-self-host && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cometchat-self-host
GitHub stars
129
Token cost
~1.6k tokens
SKILL.md length
692 words
Files
1
Skills in repo
97
Repo updated
First seen
Licence
MIT

At a glance

Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted…

  • Works in 6 steps: Treating on-prem as self-serve — it's a… → Under-sizing — plan hosts from MAU/PCC… → Hand-writing the stack — use the… → …
  • Tasks that involve Deployment
  • SKILL.md covers Use this skill when, Why self-host (vs the SaaS…, Deployment models (pick by… and Prerequisites & sizing (before…, plus 5 more sections
  • Reaches cometchat.com

What it does

Cometchat Self Host is an agent skill from cometchat/cometchat-skills. Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted instance. CometChat's enterprise differentiator: full data sovereignty. Triggers: 'self-host cometchat', 'on-prem cometchat', 'on premise deployment', 'private cloud chat', 'air-gapped chat', 'run cometchat in our own cloud/VPC', 'data sovereignty', 'point my app at self-hosted cometchat'.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: CometChat on-premise (Docker Swarm 10k–200k MAU · Kubernetes 200k+ / multi-region · air-gapped). Clients: any CometChat UI Kit / SDK pointed at your domain.

It sits in DevOps & Cloud, covering Deployment, Container orchestration and Containers. It works with CometChat, Docker and Kubernetes. The repository describes itself as: Add CometChat chat & messaging and voice & video calls to any React, Next.js, React Native, Angular, Android, iOS, or Flutter project through your AI coding agent. Works with… The licence is MIT.

When your agent uses it

  • Tasks that involve Deployment
  • Tasks that involve Container orchestration
  • Tasks that involve Containers

Example prompts

  • “s enterprise differentiator: full data sovereignty. Triggers:”
  • “on-prem cometchat”
  • “on premise deployment”
  • “/cometchat-self-host”

Requirements

  • Docker
  • Compatibility (from SKILL.md): CometChat on-premise (Docker Swarm 10k–200k MAU · Kubernetes 200k+ / multi-region · air-gapped). Clients: any CometChat UI Kit / SDK pointed at your domain.

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Treating on-prem as self-serve — it's a licensed offering; start with sales for images + license + support.
  2. Under-sizing — plan hosts from MAU/PCC via the prerequisites, not a guess.
  3. Hand-writing the stack — use the documented deployment scripts; drift breaks upgrades.
  4. App still pointing at *.cometchat.io — set the client host override to your domain, or you're on SaaS, not on-prem.
  5. Guessing the host-override field — fetch the exact setting from the on-prem client docs.
  6. No TLS / exposed data stores — terminate TLS at the LB and keep TiDB/Mongo/Redis/Kafka on the private network.

What it can do on your machine

Read from SKILL.md and the folder at commit 911b108. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • cometchat.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    CometChat on-premise (Docker Swarm 10k–200k MAU · Kubernetes 200k+ / multi-region · air-gapped). Clients: any CometChat UI Kit / SDK pointed at your domain.

    From compatibility in the SKILL.md frontmatter.

Context cost

Cometchat Self Host loads about 1.6k tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 692 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cometchat/cometchat-skills at commit 911b108, republished under its MIT licence (© cometchat). 692 words, ~1,650 tokens.

Download SKILL.mdSave it as .claude/skills/cometchat-self-host/SKILL.md (or your agent's skills folder).
name
cometchat-self-host
description
Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted instance. CometChat's enterprise differentiator: full data sovereignty. Triggers: 'self-host cometchat', 'on-prem cometchat', 'on premise deployment', 'private cloud chat', 'air-gapped chat', 'run cometchat in our own cloud/VPC', 'data sovereignty', 'point my app at self-hosted cometchat'.
compatibility
CometChat on-premise (Docker Swarm 10k–200k MAU · Kubernetes 200k+ / multi-region · air-gapped). Clients: any CometChat UI Kit / SDK pointed at your domain.
license
MIT
metadata.author
CometChat
metadata.version
1.0.0
metadata.tags
cometchat self-host on-prem on-premise kubernetes docker air-gapped data-sovereignty private-cloud enterprise

Ground truth: deployment detail is FETCHED from the live on-premise docs — {DOCS_BASE}/on-premise-deployment/docker/overview, /docker/prerequisites, /docker/production-deployment, /docker/security, /docker/persistence-and-backup, /docker/configuration-reference, /docker/air-gapped-deployment, and /kubernetes/overview (DOCS_BASE = https://www.cometchat.com/docs; append .md). On-prem is a licensed enterprise offering — contact CometChat sales for the images, license, and support. The exact client host-override field is in the on-prem client/configuration docs — fetch it there; do not guess a setting name.

Use this skill when

The customer needs the chat backend inside their own perimeter: data sovereignty, an offline/air-gapped network, a regulated industry, a residency clause the SaaS regions can't meet, or fixed-cost infrastructure instead of per-MAU SaaS pricing. Self-hosting (on-premise deployment) is a CometChat enterprise offering — position it as a differentiator, but don't assert what specific competitors do or don't offer without checking their current docs.

Why self-host (vs the SaaS regions)

  • Data sovereignty — all data (messages, media, backups) stays on infrastructure you control, which supports your GDPR/HIPAA/SOC 2 and residency obligations (compliance is the customer's to certify; self-hosting removes the SaaS data-location constraint). (Region selection in SaaS is cometchat-compliance; self-host is the stronger step.)
  • Air-gapped / private network — deploy with no public internet dependency (/docker/air-gapped-deployment).
  • Predictable economics — fixed infra cost, no per-user SaaS pricing.
  • Operational control — your monitoring, your security perimeter, direct component access.

Deployment models (pick by scale)

ModelTargetUse when
Docker Swarm~10k–200k MAU, ~20k peak concurrentmost on-prem deployments; lower operational overhead (/docker/overview)
Kubernetes200k+ MAU, multi-region active-active, autoscalinglarge scale or multi-region (/kubernetes/overview)
Air-gappedoffline / isolated networksexport images, transfer, run from a local registry (/docker/air-gapped-deployment)

The platform is microservices (WebSocket gateway · Chat API · Moderation · Notifications · Webhooks) over a Kafka event bus, with TiDB (distributed SQL) + MongoDB + Redis and optional S3-compatible object storage. You don't wire these by hand — the deployment scripts do — but size the hosts for them (/docker/prerequisites).

Prerequisites & sizing (before you deploy)

Plan from MAU and peak concurrent connections (PCC): host sizing, OS, storage volumes for the stateful services (databases, Kafka, object storage), and TLS certificates for the load balancer. The full checklist is {DOCS_BASE}/on-premise-deployment/docker/prerequisites; follow it rather than improvising capacity.

Deploy (the runbook is the docs, not this file)

Deployment uses CometChat's automated scripts for consistent, zero-downtime rollouts — {DOCS_BASE}/on-premise-deployment/docker/production-deployment. Domains/environment values are set per /docker/configuration-reference (+ the domain-update guide). Do not hand-assemble the compose/stack; drive the documented scripts.

Show full SKILL.md (317 more words)Show less

Point your app at the self-hosted instance

Clients reach on-prem over HTTPS + WebSocket through your load balancer / NGINX (TLS-terminated). In the app, the CometChat init settings must target your domain instead of the SaaS region endpoint — the exact host/region-override field is in the on-prem client-integration + configuration-reference docs; fetch it there and set it, then keep everything else (App ID, login flow) the same. Every family's init lives in cometchat-<family>-core; only the host target changes for on-prem. Verify the app connects to your domain (not *.cometchat.io) in the network tab.

Security & operations

  • Auth: on-prem uses JWT-based authentication with RSA key pairs — only authorized users reach the platform ({DOCS_BASE}/on-premise-deployment/docker/security). Combine with the app-level access model in cometchat-security.
  • Network: keep data stores on the private overlay; expose only the load balancer; enforce TLS end-to-end.
  • Backups & DR: automated backups with point-in-time recovery and retention aligned to your compliance policy (/docker/persistence-and-backup) — this is where you own the retention lifecycle cometchat-compliance defers to.
  • Monitoring: the stack ships Prometheus + Grafana + Loki; wire alerts to your on-call.

Common pitfalls

  1. Treating on-prem as self-serve — it's a licensed offering; start with sales for images + license + support.
  2. Under-sizing — plan hosts from MAU/PCC via the prerequisites, not a guess.
  3. Hand-writing the stack — use the documented deployment scripts; drift breaks upgrades.
  4. App still pointing at *.cometchat.io — set the client host override to your domain, or you're on SaaS, not on-prem.
  5. Guessing the host-override field — fetch the exact setting from the on-prem client docs.
  6. No TLS / exposed data stores — terminate TLS at the LB and keep TiDB/Mongo/Redis/Kafka on the private network.

Verify it works

The stack deploys via the documented scripts and health checks pass · the app connects to YOUR domain over HTTPS/WSS (confirmed in the network tab), logs in, sends and receives · JWT/RSA auth is enforced · data stores are private + TLS everywhere · backups run and a restore is tested · Grafana shows the services healthy.

© cometchat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cometchat-self-host of cometchat/cometchat-skills.

Open the folder on GitHubat commit 911b108

Compare with similar skills

Cometchat Self Host next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cometchat Self Host compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cometchat Self Host this skillcometchat/cometchat-skills129—~1.6kAutomated safety check: PassMIT
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Debug Openshell ClusterNVIDIA/OpenShell15k—~19kAutomated safety check: NotesApache-2.0
Deploymentmatrixorigin/memoria607—~1.6kAutomated safety check: NotesApache-2.0
Onboarding Validationopen-edge-platform/edge-ai-suites140—~3.3kAutomated safety check: PassApache-2.0
Agenticx DeployerDemonDamon/AgenticX279—~866Automated safety check: PassApache-2.0

Similar skills

  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Debug Openshell Cluster

    NVIDIA/OpenShell

    Official

    Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.

    15k GitHub stars~19k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Deployment

    matrixorigin/memoria

    Deploy Memoria with Docker Compose or Kubernetes. An agent skill from matrixorigin/memoria.

    607 GitHub stars~1.6k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Onboarding Validation

    open-edge-platform/edge-ai-suites

    Validate the get-started experience of Open Edge Platform (OEP) software components from the perspective of a first-time user.

    140 GitHub stars~3.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Agenticx Deployer

    DemonDamon/AgenticX

    Guide for deploying AgenticX agents to production including Docker containerization, Kubernetes orchestration, Volcengine AgentKit cloud deployment, and API server setup.

    279 GitHub stars~866 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Vss Deploy Warehouse Helm

    NVIDIA-AI-Blueprints/video-search-and-summarization

    A skill your agent uses when the user asks to deploy, upgrade, or size the VSS warehouse blueprint (2D / 3D / MV3DT) on Kubernetes via Helm — as opposed to Docker Compose, which is covered by…

    1.9k GitHub stars~4.2k tokensUpdated today
    DevOps & CloudAuto-check passed

More from cometchat/cometchat-skills

All 97 skills in this repo
  • CometChat Android Calls SDK v5

    cometchat/cometchat-skills

    Adds voice and video calling to an Android app in Kotlin with the headless CometChat Calls SDK v5, covering meeting-style rooms, 1:1 ringing calls, call logs and recording.

    129 GitHub stars~5.2k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Android v5 Headless SDK

    cometchat/cometchat-skills

    Builds chat on Android with your own UI against the headless CometChat Chat SDK v5, covering install, Jetifier conflicts, credentials and init-before-login ordering.

    129 GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Component Picker

    cometchat/cometchat-skills

    Picks and customizes CometChat's Angular UI Kit components by their verified component list, exact input and output event names, and the surfaces that have no kit component at all.

    129 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Features

    cometchat/cometchat-skills

    Enables or builds CometChat features such as polls, reactions, smart replies and pinned messages in an Angular app, first classifying how much client code each one needs.

    129 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Chat Placement

    cometchat/cometchat-skills

    Decides where CometChat chat UI goes in an Angular app: a dedicated route, a dashboard panel, a support widget or the full multi-pane app, with thread and search panels.

    129 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Cometchat iOS V5 SDK

    cometchat/cometchat-skills

    Add voice & video calling to any iOS app FROM SCRATCH with the headless CometChat Calls SDK v5 (CometChatCallsSDK, via Swift Package Manager) — no UI Kit.

    129 GitHub stars~5.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Cometchat Self Host

What does Cometchat Self Host do?

Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted…. Cometchat Self Host is an agent skill from cometchat/cometchat-skills. Run CometChat on your own infrastructure — when to self-host, the deployment models (Docker Swarm, Kubernetes, air-gapped), sizing & prerequisites, and how to point your app at the self-hosted instance.

When should I use Cometchat Self Host?

Cometchat Self Host fits situations like: tasks that involve Deployment; tasks that involve Container orchestration; tasks that involve Containers.

How do I install Cometchat Self Host in Claude Code?

Run `npx skills add cometchat/cometchat-skills --skill cometchat-self-host -a claude-code`. Or copy the skill folder (skills/cometchat-self-host in cometchat/cometchat-skills) into .claude/skills/cometchat-self-host in your project. Claude Code loads it when a task matches its description.

How do I install Cometchat Self Host in Codex?

Run `npx skills add cometchat/cometchat-skills --skill cometchat-self-host -a codex`. Or copy the skill folder (skills/cometchat-self-host in cometchat/cometchat-skills) into .agents/skills/cometchat-self-host in your project. Codex loads it when a task matches its description.

Can I use Cometchat Self Host in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cometchat/cometchat-skills --skill cometchat-self-host -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cometchat-self-host, .gemini/skills/cometchat-self-host, .github/skills/cometchat-self-host and .opencode/skills/cometchat-self-host in your project.

What does Cometchat Self Host need to run?

SKILL.md names no scripts, command-line tools or credentials: Cometchat Self Host is instructions for the agent only. Our summary lists: Docker. Compatibility (from SKILL.md): CometChat on-premise (Docker Swarm 10k–200k MAU · Kubernetes 200k+ / multi-region · air-gapped). Clients: any CometChat UI Kit / SDK pointed at your domain..

Does Cometchat Self Host access the network?

SKILL.md names 1 domain. In commands or code: cometchat.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Cometchat Self Host safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cometchat Self Host use?

Cometchat Self Host is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cometchat Self Host use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cometchat Self Host?

Skills that share tags, products or a category with Cometchat Self Host: LangBot Deployment Guide (langbot-app/LangBot, 18k stars), Debug Openshell Cluster (NVIDIA/OpenShell, 15k stars), Deployment (matrixorigin/memoria, 607 stars) and Onboarding Validation (open-edge-platform/edge-ai-suites, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cometchat Self Host?

cometchat (a GitHub organization) maintains it in cometchat/cometchat-skills, which has 129 GitHub stars. The repository holds 97 skills in this directory. The repository was last updated on October 5, 2026.

Source: cometchat/cometchat-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.