Installation

Quick Start#

Docker is the preferred installation method, but all options work.

docker run -d \
  --name MatchExec \
  -p 3000:3000 \
  -e TZ=UTC \
  -v $(pwd)/app_data:/app/app_data \
  -v $(pwd)/uploads:/app/public/uploads \
  ghcr.io/slamanna212/matchexec:latest

git clone https://github.com/slamanna212/MatchExec.git

cd MatchExec

docker compose up -d

Search for MatchExec in the Community Apps
section of the Unraid Web Interface

Coming Soon

helm install matchexec ./kubernetes/helm/matchexec \
  --set image.repository=ghcr.io/yourorg/matchexec \
  --set image.tag=latest \
  --set secret.DISCORD_BOT_TOKEN="your-token"

ingress:
  enabled: true
  className: nginx
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
  hosts:
    - host: matchexec.example.com
      paths:
        - path: /
          pathType: Prefix

metrics:
  serviceMonitor:
    enabled: true
    labels:
      release: kube-prometheus-stack  # match your Prometheus selector
  grafana:
    dashboardConfigMap: true  # auto-discovered by Grafana sidecar

MatchExec will be available on port 3000.

Running Dev Builds#

MatchExec has relatively stable dev builds. The dev releases are used as final testing before a full release.

You can run dev builds by using the dev docker tag for the Docker and Unraid install methods. For Docker Compose, clone the dev branch instead of main.

Running from Source#

1. Clone the Repo
2. Install Node.js 24
3. npm install
4. npm run build (builds Next.js app + processes)
5. npm run migrate
6. npm run prod:start