lahirudilhara/webchat-backend repository overview

⁠WebChat Backend Docker Image

⁠Overview

This Docker image provides the backend for the WebChat application, built with Spring Boot.

The backend handles:

• User management – create, update, delete users
• Room management – create and manage chat rooms
• Message management – store and retrieve messages
• Real-time communication – WebSocket support for instant messaging
• Integration with PostgreSQL and Redis – persistence and caching

The image is designed to be environment-agnostic, with all database and cache configurations provided via environment variables, making it easy to deploy in Docker Compose or Docker Swarm.

⁠Features

• REST API endpoints for users, rooms, and messages
• WebSocket endpoints for real-time chat
• PostgreSQL-backed persistence for reliable storage
• Redis-based caching for fast message retrieval and session handling
• Configurable via environment variables — no need to rebuild the image for different environments

⁠Environment Variables

The following environment variables must be set when running the container:

⁠Example Docker Compose

version: "3.9"
services:
  backend:
    image: lahiru/webchat-backend:v1.0
    environment:
      - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/webchat
      - SPRING_DATASOURCE_USERNAME=webchat_user
      - SPRING_DATASOURCE_PASSWORD=secret
      - SPRING_CACHE_TYPE=redis
      - SPRING_DATA_REDIS_HOST=redis
      - SPRING_DATA_REDIS_PORT=6379
    ports:
      - "8080:8080"
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_DB=webchat
      - POSTGRES_USER=webchat_user
      - POSTGRES_PASSWORD=secret
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  pgdata: