# Installation<no value>
## Quick Start

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

{{< tabs "install-app" >}}
{{< tab "Docker" >}}

```bash
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
```
{{< /tab >}}
{{< tab "Compose" >}}

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

cd MatchExec

docker compose up -d
```

{{< /tab >}}
{{< tab "Unraid" >}}
```markdown
Search for MatchExec in the Community Apps
section of the Unraid Web Interface
```
{{< /tab >}}
{{< tab "Proxmox" >}}
```markdown
Coming Soon
```
{{< /tab >}}
{{< tab "Kubernetes" >}}
### Quick Install

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

#### With Ingress

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

#### With Prometheus Monitoring

```yaml
metrics:
  serviceMonitor:
    enabled: true
    labels:
      release: kube-prometheus-stack  # match your Prometheus selector
  grafana:
    dashboardConfigMap: true  # auto-discovered by Grafana sidecar
```
{{< /tab >}}
{{< /tabs >}}


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
{{< callout context="caution" title="Caution" icon="outline/alert-triangle" >}}
This is not recommended for live environments, testing only.
{{< /callout >}}
{{< steps >}}
{{< step >}}
Clone the Repo
{{< /step >}}
{{< step >}}
Install Node.js 24
{{< /step >}}
{{< step >}}
`npm install`
{{< /step >}}
{{< step >}}
`npm run build` (builds Next.js app + processes)
{{< /step >}}
{{< step >}}
`npm run migrate`
{{< /step >}}
{{< step >}}
`npm run prod:start`
{{< /step >}}
{{< /steps>}}