Matter Enterprise Docker Compose Setup

You need to have private registery docker credentials. Contact Matter AI team at support@matterai.dev

This repository contains Docker Compose configuration for running the Matter Enterprise application stack. The setup includes three main services: a backend API server, a frontend web application, and a PostgreSQL database.

Services

Matter Backend

• Image: gravitycloud/matter-enterprise:latest
• Port: 8080
• Dependencies: PostgreSQL database
• Resource Limits: 0.5 CPU, 512MB memory

Matter Frontend

• Image: gravitycloud/matter-frontend:latest
• Port: 80
• Dependencies: Matter Backend
• Custom Configuration: Uses a custom Nginx configuration mounted from ./config/nginx.conf
• Resource Limits: 0.5 CPU, 512MB memory

PostgreSQL Database

• Image: postgres:latest
• Port: 5432
• Credentials:
  • Username: postgres
  • Password: postgres
  • Database: postgres
• Persistence: Data is stored in a Docker volume named postgres-data
• Resource Limits: 0.5 CPU, 512MB memory

Network Configuration

All services are connected through a bridge network named matter-network.

Getting Started

Prerequisites

• Docker and Docker Compose installed on your system
• At least 2GB of available RAM for the containers

Running the Application

1. Clone this repository to your local machine
2. Navigate to the repository directory
3. Start the services:

docker-compose up -d

4. Access the application:
   • Frontend: http://localhost:80
   • Backend API: http://localhost:80/api OR http://localhost:8080

Stopping the Application

docker-compose down

To remove all data including the PostgreSQL volume:

docker-compose down -v

Configuration

The application can be configured through environment variables in the docker-compose.yaml file.

Backend Configuration

• EMAIL_DOMAIN: Domain used for email services (default: b.com)
• POSTGRES_HOST: PostgreSQL host address
• POSTGRES_PORT: PostgreSQL port
• POSTGRES_DB: PostgreSQL database name
• POSTGRES_USER: PostgreSQL username
• POSTGRES_PASSWORD: PostgreSQL password

Troubleshooting

Viewing Logs

# View logs for all services
docker-compose logs

# View logs for a specific service
docker-compose logs matter-backend
docker-compose logs matter-frontend
docker-compose logs postgres

Restarting Services

docker-compose restart matter-backend

Resource Management

Each service has resource limits and reservations configured. Adjust these in the docker-compose.yaml file if needed for your environment.