Run Your Own Safety Cluster

Production Tech Stack & Architecture

CareRing is engineered with battle-tested open-source primitives for extreme resilience and sub-50ms message propagation.

One-Command Self-Hosting (Docker Compose)

Clone the repository and launch the containerized PostgreSQL 16 + PostGIS database and Node backend:

# 1. Clone the repository
git clone https://github.com/sahsisunny/care-ring.git
cd care-ring/backend

# 2. Configure environment
cp .env.example .env

# 3. Launch Docker stack
docker compose up -d

# 4. Verify cluster health
curl http://localhost:8080/health
# Response: {"status":"healthy","db":"connected","ws_clients":0}

Connecting the Mobile App to Your Server

The CareRing mobile app contains a built-in server switcher. You never need to rebuild or recompile the APK:

1. Install CareRing-latest.apk on your Android device.
2. On the welcome screen or in Settings → Backend Server Connection, tap the server icon.
3. Enter your self-hosted domain or IP (e.g. wss://family.yourdomain.com).
4. The app will automatically test TLS connectivity and securely bind to your private server instance.

Core API & WebSocket Endpoints