Skip to content

Installation

Two production-ready paths: Docker (recommended) and Kubernetes CronJob. A self-contained binary release is also available for hosts without a container runtime — see Quickstart → Self-contained binary alternative.

Docker

The official image is ghcr.io/preesta/preesta:latest. To use a locally built image instead, run:

docker build -t preesta:latest .
docker run --rm \
  -v "$(pwd)/config:/app/config:ro" \
  -e PREESTA_GROUP=daily \
  preesta:latest

docker build -t preesta:latest .
docker run --rm `
  -v "${PWD}/config:/app/config:ro" `
  -e PREESTA_GROUP=daily `
  preesta:latest

The config/ directory must contain appsettings.yaml, rules.yaml, and optionally secrets/appsettings.secrets.yaml. They're mounted read-only — the container has no other state.

preesta-cron

The repo's preesta-cron/ directory contains a wrapper image that bundles Preesta + cron. Mount your crontab file, the rules+secrets, and the image runs them on schedule:

docker run --rm \
  -v "$(pwd)/config:/app/config:ro" \
  -v "$(pwd)/crontab:/etc/cron.d/preesta:ro" \
  preesta-cron:latest

docker run --rm `
  -v "${PWD}/config:/app/config:ro" `
  -v "${PWD}/crontab:/etc/cron.d/preesta:ro" `
  preesta-cron:latest

Example crontab:

0 9 * * 1-5  /usr/bin/dotnet /app/Preesta.dll daily       2>&1 | logger -t preesta
0 14 * * 1-5 /usr/bin/dotnet /app/Preesta.dll standups    2>&1 | logger -t preesta

See Cron and schedules for the full schedule design.

Kubernetes

TODO — provide CronJob manifest + Helm chart skeleton.

For now a minimal CronJob:

apiVersion: batch/v1
kind: CronJob
metadata:
  name: preesta-daily
spec:
  schedule: "0 9 * * 1-5"
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: preesta
              image: preesta:latest
              args: ["daily"]
              volumeMounts:
                - name: config
                  mountPath: /app/config
                  readOnly: true
                - name: secrets
                  mountPath: /app/config/secrets
                  readOnly: true
          volumes:
            - name: config
              configMap:
                name: preesta-config
            - name: secrets
              secret:
                secretName: preesta-secrets

preesta-config ConfigMap holds appsettings.yaml + rules.yaml; preesta-secrets Secret holds appsettings.secrets.yaml. Multiple CronJobs (one per tag) keep the schedule definition in Kubernetes rather than a separate cron file.

Upgrading

See Upgrading for the breaking-change policy and per-version notes.