Skip to content

Palisade v3.4.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:30
· 11 commits to main since this release
  • (#328) Helm chart: single-replica deployment with a persistent /data volume
  • (#329) Keep the database across Kubernetes upgrades, rollbacks and uninstalls
  • (#330) Load the DB key, first admin and TLS files from Kubernetes Secrets
  • (#331) Resolve the real client IP behind Kubernetes Ingress and cloud load balancers
  • (#332) TLS options on Kubernetes: Ingress termination, built-in ACME, cert-manager
  • (#333) Separate admin Service and NetworkPolicy in the Helm chart
  • (#334) Optional Varnish sidecar in the Helm chart
  • (#335) Prometheus ServiceMonitor and Grafana dashboard
  • (#336) Write the access log to stdout for kubectl logs and log shippers
  • (#337) Declarative config for GitOps: import a config file on install
  • (#338) Publish the Helm chart with each release and test it in CI
  • (#339) Kubernetes and Helm documentation

Install (Linux)

curl -fsSL https://waf-install.astrareconslabs.com/palisade-waf/install.sh | sudo bash

Pin to this exact version:

curl -fsSL https://waf-install.astrareconslabs.com/palisade-waf/install.sh | sudo PALISADE_VERSION=v3.4.0 bash

Re-running the installer is safe. It upgrades the binary and restarts the service without touching your existing config or database.

Docker

docker run -d --name palisade -p 8080:8080 -v coraza-waf-data:/data ghcr.io/sinhaparth5/palisade-waf:3.4.0

Multi-arch (linux/amd64, linux/arm64). Persistent state (waf.db, certs/) lives under /data — mount a volume there. Also published to Docker Hub.

Kubernetes (Helm)

helm install waf oci://ghcr.io/sinhaparth5/charts/palisade --version 3.4.0 -n palisade --create-namespace

Or helm repo add palisade https://sinhaparth5.github.io/palisade-waf. Chart docs: deploy/helm/palisade.

Verify checksums

sha256sum --check checksums.txt

checksums.txt and the SBOM are signed with cosign (keyless, GitHub OIDC). The installer checks the signature when cosign is installed, or check it yourself:

cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json \
  --certificate-identity "https://github.com/sinhaparth5/palisade-waf/.github/workflows/ci.yml@refs/tags/v3.4.0" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

What's inside the binary

Everything is embedded, so no external files are needed at runtime:

  • Admin UI (HTMX + Tailwind templates + minified JS)
  • Bundled GeoLite2 Country database (geo blocking)
  • Bundled DB-IP ASN Lite database (ISP/org lookup)
  • OWASP Core Rule Set (WAF rules)

The only files created on disk at runtime are waf.db (SQLite) and certs/ (TLS, if enabled).