EnderDash deploy

Public deployment files for the EnderDash standalone agent.

Before you begin, copy the agent key from your EnderDash server setup page. Replace <agentKey> in the examples with that value.

Docker Compose

To run the agent with Docker Compose:

curl -fsSLO https://raw.githubusercontent.com/enderdash-com/deploy/main/agent/compose.yaml
cat > .env <<'EOF'
ENDERDASH_AGENT_KEY=<agentKey>
EOF
docker compose up -d

To check the container:

docker compose ps

Podman Quadlet

To run the agent as a rootless Podman systemd user service:

mkdir -p ~/.config/containers/systemd
curl -fsSL https://raw.githubusercontent.com/enderdash-com/deploy/main/agent/quadlet/enderdash-agent.container \
  -o ~/.config/containers/systemd/enderdash-agent.container
curl -fsSL https://raw.githubusercontent.com/enderdash-com/deploy/main/agent/quadlet/enderdash-agent-data.volume \
  -o ~/.config/containers/systemd/enderdash-agent-data.volume

cat > ~/.config/containers/systemd/enderdash-agent.env <<'EOF'
ENDERDASH_AGENT_KEY=<agentKey>
EOF
chmod 600 ~/.config/containers/systemd/enderdash-agent.env

systemctl --user enable --now podman.socket
systemctl --user daemon-reload
systemctl --user enable --now enderdash-agent.service

To check the service:

systemctl --user status enderdash-agent.service

Kubernetes Kustomize

Create the namespace and Secret:

kubectl create namespace enderdash
kubectl -n enderdash create secret generic enderdash-agent \
  --from-literal=agentKey='<agentKey>'

Install the read-only manifests:

kubectl apply -k 'https://github.com/enderdash-com/deploy//agent/kustomize/base?ref=main'

Install operator mode instead when EnderDash should be allowed to run actions such as restarts, scaling, exec, port-forward, debug containers, and YAML apply or delete:

kubectl apply -k 'https://github.com/enderdash-com/deploy//agent/kustomize/operator?ref=main'

To check the deployment:

kubectl -n enderdash get pods -l app.kubernetes.io/name=enderdash-agent

Helm

The Helm chart is published from the enderdash-com/helm-charts repository.

helm repo add enderdash https://charts.enderdash.com
helm repo update
helm install enderdash-agent enderdash/enderdash-agent \
  --namespace enderdash \
  --set rbac.mode=readonly