Getting Started
System Prerequisites
Verify minimum hardware, software, and network requirements before installing JChat.
Minimum Hardware Requirements
Because JChat runs on Bun and Elysia, resource consumption is exceptionally lightweight compared to traditional Node.js or Python alternatives.
| Resource | Minimum Spec | Recommended (Production) | Purpose |
|---|---|---|---|
| CPU | 1 vCPU (x86_64 / ARM64) | 2+ vCPUs | Bun event loop execution & real-time message compression |
| RAM | 1 GB | 2 - 4 GB | PostgreSQL cache, Redis pub/sub queue, and SSR rendering |
| Disk | 10 GB SSD | 25+ GB NVMe SSD | Persistent database volumes, container layers & attachments |
| Network | 100 Mbps | 1 Gbps (Ports 80 & 443) | WebSocket streaming latency & automatic SSL certificate renewal |
Choose Your Deployment Path
Choose between containerized deployment with Docker Compose (recommended) or standalone bare-metal installation:
The simplest and most reliable production deployment path. All database, caching, reverse-proxy, and application processes are orchestrated automatically.
Install Docker Engine & Compose Plugin
Run the official Docker automated installation script for Ubuntu, Debian, CentOS, or Fedora:
curl -fsSL https://get.docker.com | shAdd your current user to the docker group to execute commands without sudo:
sudo usermod -aG docker $USERVerify Docker & Compose Installation
Confirm that both the Docker daemon and the Docker Compose plugin (v2+) are active:
docker compose version
docker version