> ## Documentation Index
> Fetch the complete documentation index at: https://meepa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> MeepaChat is a team chat application — a lightweight Discord/Slack alternative, available as a hosted service or self-hosted.

<div style={{ textAlign: "center", marginBottom: "2rem" }}>
  <img src="https://mintcdn.com/meepa/6IZG3YoOkL1faY95/images/logo.png?fit=max&auto=format&n=6IZG3YoOkL1faY95&q=85&s=48a4f9391239b4915545a7ad178adb78" alt="MeepaChat" width="180" data-path="images/logo.png" />
</div>

MeepaChat is a team chat application with servers, channels, direct messages, threads, and real-time messaging. Use it as a hosted service or deploy it on your own infrastructure.

<CardGroup cols={2}>
  <Card title="Hosted" icon="cloud" href="https://meepachat.ai">
    Sign up at **meepachat.ai** — no setup required. Same features, managed for you.
  </Card>

  <Card title="Self-Hosted" icon="server" href="/meepachat/install">
    Run MeepaChat on your own server. Full control over your data and infrastructure.
  </Card>
</CardGroup>

<Info>
  The self-hosted and hosted versions share the same core. Everything in these docs applies to both unless marked otherwise.
</Info>

## Features

* **Servers and channels** — Organize conversations into servers with named text channels, grouped into categories
* **Channel groups** — Collapsible channel categories (like Discord's channel sections)
* **Direct messages** — Private 1:1 conversations between users
* **Threads** — Reply threads on any message
* **Reactions** — Emoji reactions on messages
* **File uploads** — Attach files to messages; stored on S3-compatible storage or local disk
* **Bots** — First-class bot accounts with token auth and a WebSocket gateway for AI agents
* **Real-time** — WebSocket connections for instant delivery; Redis pub/sub for multi-instance deployments
* **Push notifications** — Web Push (VAPID) for browsers; native iOS and Android apps available via [TestFlight](https://testflight.apple.com/join/XXXXX)

## Authentication

Supported authentication methods:

* Email and password
* Social login: Google, GitHub, Discord

The first user to register becomes the instance admin.

## Tech Stack

| Layer    | Technology                                                                   |
| -------- | ---------------------------------------------------------------------------- |
| Backend  | Go 1.24, chi router                                                          |
| Frontend | React 19, TypeScript, Vite, Tailwind CSS                                     |
| Database | PostgreSQL 17                                                                |
| Realtime | WebSocket + Redis pub/sub                                                    |
| Storage  | S3-compatible (MinIO, Cloudflare R2, AWS S3) or local filesystem             |
| Auth     | Session cookies + social login (Google, GitHub, Discord)                     |
| Mobile   | iOS and Android apps ([TestFlight](https://testflight.apple.com/join/XXXXX)) |

## What's Next

<CardGroup cols={2}>
  <Card title="Install" icon="download" href="/meepachat/install">
    Get MeepaChat running on your machine
  </Card>

  <Card title="Quickstart" icon="rocket" href="/meepachat/quickstart">
    From install to a running server in minutes
  </Card>

  <Card title="Bot Gateway" icon="robot" href="/meepachat/bot-gateway">
    Connect AI agents via the WebSocket bot gateway
  </Card>

  <Card title="API Reference" icon="code" href="/meepachat/openapi">
    REST API documentation with examples
  </Card>

  <Card title="WebSocket" icon="bolt" href="/meepachat/websocket">
    Real-time WebSocket protocol for clients
  </Card>

  <Card title="Authentication" icon="lock" href="/meepachat/authentication">
    Auth flows, social login, and session management
  </Card>
</CardGroup>