Skip to main content
This guide walks you through deploying MatterAI in your own infrastructure using Docker Compose, which is ideal for smaller deployments or testing environments.

Prerequisites

You need to have private registery docker credentials. Contact MatterAI team at support@matterai.so
  • A server with Docker and Docker Compose installed
  • GitHub App credentials (see Create Your Own GitHub App)
  • Minimum system requirements:
    • 1 CPU cores
    • 2GB RAM
    • 10GB storage
  • Domain name with SSL certificate (for webhook endpoints)

Step 1: Download the docker-compose repository

Sample Docker Compose file:

Step 2: Configure Proxy for Backend APIs (Default works, no Change needed)

This nginx proxy is used to enables routing to backend APIs via frontend security. Here’s the default Nginx configuration:

Step 3: Deploy MatterAI

Step 4: Visit the UI and create a new account

  • Access the MatterAI web interface at http://your-domain.com
  • Access the MatterAI backend at http://your-domain.com/api

Maintenance and Updates

Updating MatterAI

To update to the latest version of MatterAI:

Backup and Restore

It’s recommended to regularly backup your PostgreSQL database:

Troubleshooting

Common Issues

  1. Webhook not receiving events
    • Verify your webhook URL is correctly configured in your GitHub App
    • Check that your server is accessible from the internet
    • Ensure your SSL certificate is valid
  2. Database connection issues
    • Check the PostgreSQL logs: docker-compose logs postgres
    • Verify the database credentials in your .env file
  3. API service not starting
    • Check the API logs: docker-compose logs api
    • Verify all required environment variables are set correctly

Next steps

Configure MatterAI

Configure MatterAI for your enterprise deployment