Release & Upgrade Guide

Overview

Vaultwarden-Plus release and upgrade decisions should follow the canonical repository documentation. The current stable line is v1.36.3.

Requirements

• Review release notes before upgrading.
• Confirm CI and publish-surface validation are green for release commits.
• Use the published image or a locally validated build.
• Preserve backups for files and database before operational changes.
• Keep Web Vault on the validated bundled version for the release.

Configuration

Current stable image:

forgejo.sabolowitsch.org/stefansa/vaultwarden-plus:1.36.3

Current release also documents latest and short-SHA image tags. No database migration or configuration migration is required for v1.36.3.

Examples

Docker image reference:

image: forgejo.sabolowitsch.org/stefansa/vaultwarden-plus:1.36.3

Before upgrading, read the release notes and known limitations for mail, Account Recovery, passkeys, trusted-device/auth-request previews, and TLS stance.

Troubleshooting

• If mail-dependent features fail after an upgrade, validate SMTP, sendmail, or SES first.
• If Account Recovery behavior changes, confirm the deployment is using the validated Web Vault 2026.4.1 release path.
• Do not create a release from Wiki content; releases are governed by repository release documentation.

Related Pages

• Account Recovery
• SMTP Configuration
• Troubleshooting

Canonical Documentation

• Changelog
• v1.36.3 Release Notes
• Maintainer Guide
• Known Limitations