reloopsh/be-auth repository overview

⁠🔐 Reloop — Auth Service

The Auth Service is the central authentication and session management microservice in the Reloop⁠ platform. It handles user sign-up, sign-in, OAuth social logins (Google, GitHub), OTP-based email verification, and organization-scoped session management — all powered by Better Auth⁠.

Built on Bun⁠ + Elysia⁠ for ultra-low latency, backed by PostgreSQL and Redis.

⁠🚀 Features

• Email & Password Auth — Sign up, login, and password management
• Social OAuth — Google and GitHub login out of the box
• OTP / Magic Link — Email-based one-time password support
• Session Management — Secure session tokens via Redis
• Organization Support — Multi-tenant org-scoped access control
• Signup Control — Disable public signups via env flag
• OpenAPI Docs — Auto-generated spec at /api/auth/openapi
• NATS Bus — Event-driven integration via the Reloop message bus

⁠🔗 Quick Links

⁠⚡ Quick Start

docker pull reloopsh/be-auth:latest

docker run -d \
  -p 8000:8000 \
  -e PG_URL=postgresql://user:password@host:5432/reloop \
  -e REDIS_URL=redis://:password@host:6379 \
  -e NATS_URL=nats://host:4222 \
  -e BASE_URL=https://your-domain.com \
  -e BETTER_AUTH_SECRET=your-secret-here \
  -e GOOGLE_CLIENT_ID=your-google-client-id \
  -e GOOGLE_CLIENT_SECRET=your-google-client-secret \
  -e GITHUB_CLIENT_ID=your-github-client-id \
  -e GITHUB_CLIENT_SECRET=your-github-client-secret \
  reloopsh/be-auth:latest

The service will be available at http://localhost:8000/api/auth.

⁠🔧 Environment Variables

⁠🛠 Tech Stack

• Runtime: Bun⁠
• Framework: Elysia⁠
• Auth Library: Better Auth⁠
• Database: PostgreSQL via Drizzle ORM⁠
• Session Cache: Redis
• Messaging: NATS

⁠📦 Part of the Reloop Platform

This image is one of several microservices that make up the Reloop backend. See the full list at hub.docker.com/u/reloopsh⁠.