Self-hosted secrets manager, dynamic credentials, rotation & private tunnels in one container.
300
Zero-bloat self-hosted secrets operations for modern engineering teams.
Deploy a complete secrets vault, dynamic credential broker, automated secret rotation engine, and private network tunnel gateway in one single static binary—no Redis, no ZooKeeper, no external database required to start, and zero SaaS lock-in.
Legacy secret managers force an uncomfortable trade-off: brittle .env files scattered across laptops and CI runners, or heavy distributed stacks requiring dedicated ops teams, multiple containers, and mandatory SaaS telemetry.
DuckSecrets gives security and platform teams enterprise-grade control with desktop-simple deployment:
| Capability | .env Files | Heavy Multi-Service Vaults | DuckSecrets |
|---|---|---|---|
| Deployment footprint | Ad-hoc files | 3–6+ containers + external DB | 1 static binary (~20 MB) or single Docker container |
| Embedded database + HA upgrade | — | External DB mandatory | SQLite out-of-the-box + 1-click live migration to PostgreSQL |
| Dynamic JIT credentials | No | Complex plugin setup | Built-in (PostgreSQL, MySQL, Redis, Linux PAM) with auto-lease reaper |
| Private VPC/NAT access | VPN / bastion host | Separate agent infrastructure | Network Sites — built-in outbound WebSocket reverse tunnels |
| Managed localhost dev tunnels | Manual SSH tunnels | External proxies | ducksecrets connect — ephemeral localhost proxy injecting JIT creds |
| Zero-knowledge ephemeral shares | Slack/email plaintext | Often separate add-on | Client-side AES-256-GCM burn-after-reading bundles built in |
| Automated rotation + verification | Manual | Enterprise tier only | Built-in scheduler with rollback-on-failed-probe safety |
| Offline air-gapped operation | Yes | Often phones home | 100% air-gapped (embedded assets, offline Ed25519 licensing) |
development, staging, production, custom) → Nested Folders → Versioned Key-Value Secrets with diffing, instant rollback, masked UI views, and ${REF} / dynamic interpolation.PostgreSQL, MySQL, Redis, Linux PAM) on demand and automatically revoke leases when they expire or when a session closes.ducksecrets connect.ducksecrets CLI): Inject secrets directly into subprocesses (ducksecrets run -- ...) without touching disk, export .env/json/yaml, or scope machine tokens (duck_st_*) by IP CIDR allowlists and single-use execution.DUCKSECRETS_ADMIN_PASSWORD for unattended automation).X-Forwarded-* + WebSocket support; see deploy/nginx/ducksecrets.conf).latest public releases with automatic SHA256SUMS verification (ducksecrets update, ducksecretsd update, or Web UI)./v1/*): Connect unmodified HashiCorp Vault clients, Kubernetes External Secrets Operator, Terraform vault provider, or the vault CLI directly against DuckSecrets (KV v1/v2, Cubbyhole, Credentials Vault, Dynamic Database Leases, Transit Encryption-as-a-Service, AppRole/Userpass/Token Auth, and Response Wrapping).Download installers and static binaries from the Releases page:
.deb)curl -fsSLO https://github.com/leandrofus/ducksecrets-ce/releases/latest/download/ducksecrets-0.3.0-linux-amd64.deb
sudo dpkg -i ducksecrets-0.3.0-linux-amd64.deb
sudo systemctl enable --now ducksecrets
.rpm)sudo dnf install -y https://github.com/leandrofus/ducksecrets-ce/releases/latest/download/ducksecrets-0.3.0-linux-amd64.rpm
sudo systemctl enable --now ducksecrets
pacman)curl -fsSLO https://github.com/leandrofus/ducksecrets-ce/releases/latest/download/ducksecrets-0.3.0-linux-amd64.pkg.tar.zst
sudo pacman -U ducksecrets-0.3.0-linux-amd64.pkg.tar.zst
sudo systemctl enable --now ducksecrets
Linux packages install both
ducksecrets(CLI) andducksecretsd(server), configure theducksecretssystemd service, generate a self-signed TLS certificate at/etc/ducksecrets/tls.crt, and store environment overrides in/etc/ducksecrets/env.
.msi)Download ducksecrets-0.3.0-windows-amd64.msi from Releases to install ducksecrets.exe and ducksecretsd.exe into C:\Program Files\DuckSecrets.
curl -fsSLO https://raw.githubusercontent.com/leandrofus/ducksecrets-ce/main/docker-compose.yml
docker compose up -d
# Or with dedicated PostgreSQL backend (set AUDIT_KEY and ENCRYPTION_KEY):
docker compose --profile postgres up -d
Pulls the prebuilt multi-arch
system4us/ducksecrets:latestimage, persists data in/data, and auto-provisions self-signed HTTPS by default.
https://<your-host>:5179 (or your reverse-proxy HTTPS domain).DUCKSECRETS_TLS_MODE=off and DUCKSECRETS_TRUSTED_PROXIES=127.0.0.1/8,::1/128 in /etc/ducksecrets/env (see deploy/nginx/ducksecrets.conf).Keep both CLI and daemon up to date against the latest verified ducksecrets-ce release (SHA256SUMS checked before replacing binaries):
ducksecrets update # update developer CLI
sudo ducksecretsd update # update server daemon, then: sudo systemctl restart ducksecrets
Administrators can also check and apply server updates directly under Administration → System Updates in the Web UI.
DuckSecrets ships as a single unified build with zero phone-home telemetry:
| Feature / Quota | Community (Apache-2.0) | Pro | Business |
|---|---|---|---|
| Core KV secrets, folders, versions, diff & rollback | Included | Included | Included |
Dynamic secret engines (PostgreSQL, MySQL, Redis, PAM) | Included | Included | Included |
| Automated rotation policies & verification probes | Included | Included | Included |
| HMAC-SHA256 audit chain & zero-knowledge ephemeral shares | Included | Included | Included |
RBAC, project policies & CIDR-scoped service tokens (duck_st_*) | Included | Included | Included |
| Embedded SQLite + live PostgreSQL migration | Included | Included | Included |
| First-login setup, TLS management & verified autoupdate | Included | Included | Included |
| Network Sites (reverse tunnel gateways) | Up to 2 | Up to 25 | Unlimited |
OIDC / OAuth2 Single Sign-On (sso.oidc) | — | Included | Included |
Kubernetes & automated secret sync (sync.kubernetes) | — | Included | Included |
Vault master key rotation (vault.master_key_rotation) | — | Included | Included |
SAML 2.0 / SCIM / LDAP (sso.saml) | — | — | Included |
Approval workflows / two-person rule (governance.approvals) | — | — | Included |
External KMS / HSM auto-unseal (vault.external_kms) | — | — | Included |
Compliance audit export (audit.export) | — | — | Included |
dkl1...) via -license-key, $DUCKSECRETS_LICENSE_KEY, or Admin → License in the Web UI. See LICENSE and LICENSE-EE.Prerequisites: Go 1.26+ and Bun.
make dev # Run gateway (:5179) + Vite hot-reload UI (:5173)
./scripts/check.sh # Full verification: gofmt, vet, tests, OpenAPI, sqlc, tsc
make build # Build standalone UI-embedded binaries in dist/bin/
make packages # Build static multi-arch binaries + .deb, .rpm, .pkg.tar.zst, .msi in dist/
├── gateway/
│ ├── cmd/ducksecrets/ # Developer & CI/CD CLI (zero server/DB imports)
│ ├── cmd/ducksecretsd/ # Single-binary server daemon + embedded React UI
│ ├── cmd/openapi-gen/ # Contract-first OpenAPI 3.0 AST generator
│ ├── internal/vault & crypto/ # AES-256-GCM vault & HKDF/Argon2id key derivation
│ ├── internal/auth/ # Sessions, bcrypt, RBAC, CIDR-scoped service tokens
│ ├── internal/audit/ # HMAC-SHA256 tamper-evident log
│ ├── internal/dynamic/ # PostgreSQL, MySQL, Redis, PAM dynamic secret drivers
│ ├── internal/rotation/ # Scheduled rotation + HTTP/TCP/script rollback probes
│ ├── internal/sites/ # Yamux/WebSocket reverse tunnel site gateways
│ ├── internal/tlsutil/ # Install-time self-signed TLS & live PEM hot-reload
│ ├── internal/selfupdate/ # SHA256-verified self-update engine
│ └── internal/license/ # Offline Ed25519 Open-Core entitlement verification
├── web/ # Air-gapped React 19 + TypeScript UI
├── deploy/ # systemd service, packaging (nfpm/WiX), Nginx reverse proxy
└── scripts/ # CI checks, .deb/.rpm/.msi packager, OSS publisher
Content type
Image
Digest
sha256:984d05516…
Size
13.9 MB
Last updated
6 days ago
docker pull system4us/ducksecrets