Skip to content

jackson2w/claude-code-skills / vaultwarden-deployment

vaultwarden-deployment

Verified

This skill should be used when deploying Vaultwarden (self-hosted Bitwarden-compatible server) via Docker on a bare Debian/Ubuntu VPS or VM — not a Proxmox LXC/VM fleet host. Covers loopback-only binding, Tailscale Serve exposure, the admin-token hashing tool's TTY requirement, and locking down signups after the first account exists. Trigger phrases include "deploy vaultwarden", "vaultwarden docker", "vaultwarden admin token", "vaultwarden hash preset", "No such device or address vaultwarden", "SIGNUPS_ALLOWED", "vaultwarden signups disabled verify", "update vaultwarden", "vaultwarden-install.yml", "VAULTWARDEN_ADMIN_TOKEN".

Vaultwarden deployment (Docker, single-user personal instance)

The instance this was built from is retired (2026-11-01). It held one secure note, Infisical had already taken over the secrets role, and dfw itself was being retired. Data archived to R2 immich-archive/vaultwarden/; removed by dfw-ansible vaultwarden-retire.yml. The mechanics below stay valid for a future deployment. Before standing one up again, ask whether Infisical (fleet secrets) or Will's own password manager already covers the need.

Built and verified 2026-08-15 on a Vultr VPS (dfw) as the secrets store for a broader multi-service box. Docker is fine here specifically because this is a personal/single-purpose VPS, not part of the homelab's Proxmox fleet (where Docker is banned outside LXCs/VMs — see proxmox-node-systemd-service for the native-systemd alternative used on that fleet instead).

Loopback-only bind — the port mapping syntax matters

Docker's short-form -p 8080:80 (or Compose ports: - '8080:80') publishes to 0.0.0.0 on the host, not just loopback — this is true regardless of what firewall rules exist elsewhere, and docker ps looks identical either way. Always bind explicitly:

docker run -d \
  --name vaultwarden \
  --restart unless-stopped \
  --env-file /root/.config/vaultwarden-admin.env \
  -e SIGNUPS_ALLOWED=false \
  -e WEBSOCKET_ENABLED=true \
  -v /opt/vaultwarden/data:/data \
  -p 127.0.0.1:8080:80 \
  vaultwarden/server:latest

Verify with ss -tlnp | grep 8080 — should show 127.0.0.1:8080, never 0.0.0.0:8080 or *:8080.

Expose via Tailscale Serve on a dedicated, non-default port

If the box will eventually host other services too, don't claim port 443 for Vaultwarden — leave that free for whatever ends up being the box's primary/default service, and give Vaultwarden its own:

tailscale serve --bg --https=8443 http://127.0.0.1:8080

The vaultwarden hash admin-token tool needs a REAL TTY — can't be scripted

Vaultwarden ships /vaultwarden hash --preset owasp|bitwarden to generate a properly-hashed Argon2id ADMIN_TOKEN (the documented best practice over a plaintext token). It reads the password via a library that opens /dev/tty directly, bypassing piped stdin entirely — running it non-interactively (echo "$TOKEN" | docker run --rm -i vaultwarden/server /vaultwarden hash ...) fails with:

thread 'main' panicked at src/main.rs:...: called `Result::unwrap()` on an `Err` value:
Os { code: 6, kind: Uncategorized, message: "No such device or address" }

No -t/-it combination fixes this over a non-interactive SSH command — it needs an actual attached terminal. For a personal, tailnet-only, loopback-bound instance (not internet-facing), the pragmatic trade-off is a strong random plaintext ADMIN_TOKEN instead, generated and stored server-side in one step so it never transits a chat transcript or shell history:

TOKEN=$(openssl rand -base64 48 | tr -d '\n')
printf 'ADMIN_TOKEN=%s\n' "$TOKEN" | sudo tee /root/.config/vaultwarden-admin.env >/dev/null
sudo chmod 600 /root/.config/vaultwarden-admin.env

If the instance will ever be more broadly reachable, redo this properly (via an actual interactive terminal session on the host) rather than carrying the plaintext token forward.

Signups: allow for first account, then lock down

Leave SIGNUPS_ALLOWED=true (or default) until the intended owner has created their account through the web UI — that's a personal master-password choice, never something to script or have an assistant do on someone's behalf. Once the account exists, recreate the container (env vars only take effect at container creation, not via a plain restart) with signups closed:

docker stop vaultwarden && docker rm vaultwarden
docker run -d ... -e SIGNUPS_ALLOWED=false ... vaultwarden/server:latest   # same flags as above

Verify the flag actually took — Vaultwarden's public /api/config endpoint does not expose signup status, so checking it there proves nothing. Check the container's own environment instead, and confirm the existing account's data survived the recreate:

docker exec vaultwarden printenv SIGNUPS_ALLOWED     # expect: false
curl -sk -o /dev/null -w '%{http_code}\n' https://<tailnet-url>/   # expect: 200, login page loads

Updating to a newer image — docker pull alone doesn't move the running container

This deployment has no docker-compose.yml (it's plain docker run, per the block above), so there's no docker compose pull && docker compose up -d shortcut — recreate it by hand with the same flags. Confirmed 2026-08-30 on dfw: a docker pull vaultwarden/server:latest had already been run 8 days earlier and fetched a newer image, but nothing ever recreated the container to use it — docker images vaultwarden/server showed the new image tagged :latest sitting next to the old image now tagged <none> (dangling) while the running container was still silently on that old, dangling one. docker ps gives no hint of this (Image column just shows the tag/ID either way) — always cross-check docker inspect vaultwarden --format '{{.Image}}' against docker inspect vaultwarden/server:latest --format '{{.Id}}' to see if they actually match before assuming a prior pull took effect.

Recreate procedure (same flags as the original docker run, image tag unchanged since it's always :latest):

docker pull vaultwarden/server:latest   # confirms/fetches current latest first
docker stop vaultwarden && docker rm vaultwarden
docker run -d \
  --name vaultwarden \
  --restart unless-stopped \
  --env-file /root/.config/vaultwarden-admin.env \
  -e SIGNUPS_ALLOWED=false \
  -e WEBSOCKET_ENABLED=true \
  -v /opt/vaultwarden/data:/data \
  -p 127.0.0.1:8080:80 \
  vaultwarden/server:latest

The bind-mounted /opt/vaultwarden/data is untouched by the recreate — db.sqlite3 survives with identical size/mtime, since only the container (not the volume) is replaced. Verify data integrity by ls -la on db.sqlite3 before and after (same file, not regenerated), not just that login works. After confirming the new container is healthy and both the loopback and Tailscale Serve URLs return 200, clean up the now-orphaned old image (docker images vaultwarden/server will show it dangling/<none>): docker image rm <old-image-id>.

Verification checklist

  • ss -tlnp shows 127.0.0.1:8080 only, never a wildcard bind
  • Tailscale Serve URL loads (may take ~30-60s on first request — container health check cold-start, not a failure)
  • Direct connection to the tailnet IP on the container's raw port (bypassing the Serve proxy) fails — confirms the only path in is through Serve, not a second exposed route
  • Public IP has no route to the port at all
  • SIGNUPS_ALLOWED=false confirmed via container env after the owner's account exists

Ansible-managed on dfw since 2026-10-04 — this supersedes the hand recreate above

dfw-ansible/playbooks/vaultwarden-install.yml owns the container. It was seeded from docker inspect of the live hand-run container: three env vars, 127.0.0.1:8080->80, a bind mount of /opt/vaultwarden/data, unless-stopped, the default bridge network.

  • Pinned, not :latest: vaultwarden_version: "1.37.3". To update, bump it and run cd /root/ansible && ansible-playbook playbooks/vaultwarden-install.yml on dfw as root. It only acts when the image ID differs. Then it stops the container, archives /opt/vaultwarden/data to /root/config-backups/vaultwarden-data-<ts>.tar.gz (0600, taken stopped, so the SQLite copy is consistent), recreates the container, and waits for healthy plus /alive.
  • ADMIN_TOKEN is in Infisical (homelab-fleet/dev, VAULTWARDEN_ADMIN_TOKEN), read at apply time with /usr/local/bin/infisical-get.sh. It was moved there by piping it from docker inspect to ansible-ctrl's infisical-set.sh (dfw has no write helper), never printed, and verified by sha256 against the live value. The old --env-file /root/.config/vaultwarden-admin.env in the recipe above is gone: it was shredded 2026-10-04 after a hash match against Infisical showed nothing referenced it. Infisical is now the only copy.
  • Checks after an update: docker exec vaultwarden /vaultwarden --version, then https://dfw.tail922cee.ts.net:8443/alive -> 200. /api/config's version field is the Bitwarden API compatibility version (2026.6.0), not Vaultwarden's.
  • Downtime for the 1.37.2 -> 1.37.3 recreate was about 7 s. dfw-package-check still flags newer releases, and its suggested fix points at this playbook.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 319kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall