Vaultwarden Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki

Vaultwarden Setup Guide

Introduction

Vaultwarden is a more efficient re-implementation of the Bitwarden server API aimed at self-hosting. It is compatible with Bitwarden clients and provides a secure way to manage passwords.

Prerequisites

  • Docker installed
  • Vaultwarden container running in your Docker stack
  • A domain name and SSL certificate (optional but recommended for security)

Configuration Steps

Step 1: Accessing the Vaultwarden UI

  1. Open your browser and navigate to http://<your-ip-address>:<port>.

**⚠️ Hint: Depending on your setup you might not be able to reach by IP and need to use the domain name (i.e. vault.example.com)

  1. Log in with your Vaultwarden credentials.
  2. If everything looks ok go to the admin page to configure Valutwarden's settings
     http://<your-ip-address>:<port>/admin`.
    

Step 2: Genertal settings

  1. Once the admin page is open go to the General settings blade
  2. Domain URL: https://vault.example.com
  3. Require email verification on signups: Enable
  4. Save

Vaultwarden General

Step 3: SMTP Email Settings

  1. Navigate to the SMTP Email Settings tab.
  2. Host: smtp.gmail.com
  3. From Address: [email protected]
  4. Port: 587
  5. From Name: Vaultwarden
  6. Username: [email protected]
  7. Password:
  8. Save
  9. select Send test email

Vaultwarden SMTP

Step 6: Managing Users

  1. Navigate to the Users tab.
  2. Add new users by filling the users email and clicking invite

Vaultwarden Invite

Step 7: Monitoring and Logs

  1. Go to the Dashboard tab.
  2. Monitor the status of your Vaultwarden instance, including active users and any errors.
  3. Use the logs to troubleshoot issues.

Notes

  • Ensure all paths and environment variables are updated in the vaultwarden.yaml file.
  • Regularly backup your config directory to save your settings and user data.

Troubleshooting

  • Common Issues: List common issues and solutions.
  • Logs: Check Vaultwarden logs for error messages.
  • Support: Link to the Vaultwarden community and support resources.
⚠️ **GitHub.com Fallback** ⚠️