selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

cially logo

Self-host cially

v2.0.1

Open-source Discord server analytics dashboard

ReleaseSource AvailableOther
Docker ComposeCompose file & guide
docker compose up
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
216
Ports
3000 (Web dashboard), 3001 (Bot API)
Requires
PocketBase
Docker
ghcr.io/cially/web
Dashboard overview showing server analyticsMessage analytics viewGrowth metrics or activity insightsUser search or voice chat trendsDashboard main screenCommunity analytics view

What is cially?

Cially is a self-hosted analytics platform for Discord server owners and community managers who want deep visibility into their community's behavior. It consists of a Discord bot that listens to server events, a Pocketbase backend for data storage, and a Next.js web dashboard for visualization. The dashboard shows message analytics (per hour/day/week, media shared, deletions/edits), growth metrics (joins/leaves, retention, unique users), activity insights (most active channels/users/hours, real-time member status), user search with per-user history, and voice chat trends. It runs via Docker Compose with three containers (bot, web, Pocketbase) and requires a Discord bot token and client ID to operate. The project is licensed under CC-BY-NC-ND 2.0, which prohibits commercial use and derivatives. No message content is stored unless explicitly configured.

Should you self-host cially?

cially scores 44/100 on selfhost.directory (how scoring works) and ranks #20 of 27 in Analytics. It has 216 GitHub stars.

It shipped 1 stable release in the past year. The latest, v2.0.1, came out on 31 July 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is PostHog (81/100, 40 491 stars). It scores higher overall, so compare the two before you pick. See cially vs PostHog side by side.

Features

  • Activity Insights
  • Basic Server Data
  • Growth Metrics
  • Message Analytics
  • Privacy-first
  • Real-time sync
  • User Search
  • Voice Chat Analytics

cially README

How to install cially

Install cially with Docker Compose

Environment variables
TOKEN, CLIENT_ID, API_PORT, API_URL, DEBUGGING, GUILD_COLLECTION, MESSAGE_COLLECTION, INVITE_COLLECTION, MEMBER_LEAVES_COLLECTION, MEMBER_JOINS_COLLECTION, VC_QUEUE_COLLECTION, PORT, POCKETBASE_URL, POCKETBASE_ADMIN_EMAIL, POCKETBASE_ADMIN_PASSWORD, POCKETBASE_ENCRYPTION_KEY
  1. Complete the initial setup steps (create Discord app, enable privileged intents, invite bot, grant permissions)
  2. Download or copy the docker-compose.yaml file from the docker folder.
  3. Download or copy the .env.example file from the same folder and place it in the same directory as docker-compose.yaml.
  4. Rename .env.example to .env.
  5. Open .env and update the values for TOKEN, CLIENT_ID, and POCKETBASE_URL.
    • You can use an internal Docker URL (e.g., http://cially-pocketbase:8090) to keep PocketBase private!
    • Example: http://cially-pocketbase:8090
  6. Run the following command to start everything:
    docker compose up
    

Requires Discord bot token and client ID. Pocketbase runs as a container in the same stack.

How to configure cially

  • API_PORT3001Bot API port

    Bot API port

  • API_URLhttp://cially-bot:3001Bot API URL

    Bot API URL

  • CLIENT_IDDiscord application client ID

    Discord application client ID

  • DEBUGGINGFALSEEnable bot logs

    Enable bot logs

    values: TRUE, FALSE

  • GUILD_COLLECTIONguildsPocketbase collection for guilds

    Pocketbase collection for guilds

  • INVITE_COLLECTIONinvitesPocketbase collection for invites

    Pocketbase collection for invites

  • MEMBER_JOINS_COLLECTIONmember_joinsPocketbase collection for member joins

    Pocketbase collection for member joins

  • MEMBER_LEAVES_COLLECTIONmember_leavesPocketbase collection for member leaves

    Pocketbase collection for member leaves

  • MESSAGE_COLLECTIONmessagesPocketbase collection for messages

    Pocketbase collection for messages

  • POCKETBASE_ADMIN_EMAILadmin@cially.orgPocketbase admin email

    Pocketbase admin email

  • POCKETBASE_ADMIN_PASSWORDadmin123!Pocketbase admin password

    Pocketbase admin password

  • POCKETBASE_ENCRYPTION_KEY32-character encryption key for Pocketbase settings encryption

    32-character encryption key for Pocketbase settings encryption

  • POCKETBASE_URLhttp://cially-pocketbase:8090/Pocketbase URL (internal Docker URL recommended)

    Pocketbase URL (internal Docker URL recommended)

  • PORT3000Web dashboard port

    Web dashboard port

  • TOKENDiscord bot token

    Discord bot token

  • VC_QUEUE_COLLECTIONvoice_channel_data_queuePocketbase collection for voice channel data queue

    Pocketbase collection for voice channel data queue

cially releases & version history

More in Dashboard

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…