Bitwarden is an awesome open source password manager that I've been using for a while. However I've never been entirely comfortable with storing my password database on someone else's computer, so I decided to look into options for self-hosting it.
Enter bitwarden_rs; an unofficial implementation of the Bitwarden password manager written in rust, and brings a number of advantages to the original project.
The primary goal of this project is to provide you (as a Home Assistant user) with additional, high quality, add-ons that allow you to take your automated home to the next level. Bitwarden RS is an unofficial version of Bitwarden that’s great for self-hosting. Overall, if you’re interested in self-hosting Bitwarden, this is what I consider to be the best option. There are two prerequisites that must be installed (Docker/Portainer, Nginx Proxy Manager). I will link to tutorials in the instructions if you haven’t.
- It's much more lightweight.
- It only requires a single Docker container to spin it up.
Prerequisites
So without further ado, let's get started. To follow this tutorial, you'll need:
Bitwarden, the open source password manager, makes it easy to generate and store unique passwords for any browser or device. Create your free account on the platform with end-to-end encryption and flexible integration options for you or your business.
- Our letsencrypt container installed and configured with your hostname and appropriate (sub)domains
- Your own (sub)domain setup correctly and free to dedicate to bitwarden.
Docker configuration
Although I tend to prefer to use containers we've produced ourselves, sometimes you have to admit that the original application author has hit the nail on the head with their own container, and that's the case here. So let's grab it from Docker Hub:
As you can see I've changed port 80 on the container side to be 8343 on the host as Unraid is currently using port 80. You can choose any free port for this tutorial — just remember what it is so you can configure the reverse proxy appropriately.
With that completed, let's move on.
Reverse proxy
Navigate to /config/nginx/site-confs/ on your LinuxServer.io Let's Encrypt container, and create a new server. Call the file bw.
Install Bitwarden Portainer
In this file paste the following, making sure you edit it to change the variables $IP and $HOST_PORT_FOR_80 appropriate to your own config. Save and restart the Let's Encrypt container.
Finishing Up
You should find now you can access the Bitwarden web vault at https://bw.server.com
Now you can create a new account, and if you want to migrate from Bitwarden's own hosted system, export your passwords as a .json file and import them to your new self-hosted version.
Setting up Browser Extensions & Mobile Applications
To point the browser extension to your new self hosted Bitwarden instance, you need to log out from your current Bitwarden session and then click the tiny cog in the upper left corner like below:
Fill out the Server URL box with https://bw.server.com.
Robert's your mother's brother. You're done!
WARNING! THIS IS AN EDGE REPOSITORY¶
This Home Assistant Add-ons repository contains edge builds of add-ons. Edgebuilds add-ons are based upon the latest development version.
- They may not work at all.
- They might stop working at any time.
- They could have a negative impact on your system.
This repository was created for:
- Anybody willing to test.
- Anybody interested in trying out upcoming add-ons or add-on features.
- Developers.
If you are more interested in stable releases of our add-ons:
Installation¶
Adding this add-ons repository to your Home Assistant instance ispretty straightforward. In the Home Assistant add-on store,a possibility to add a repository is provided.
Use the following URL to add this repository:
Add-ons provided by this repository¶
✓ ADB - Android Debug Bridge¶
The Android Debug Bridge server program
✓ AdGuard Home¶
Network-wide ads & trackers blocking DNS server
✓ AirCast¶
AirPlay capabilities for your Chromecast devices.
✓ AirSonos¶
AirPlay capabilities for your Sonos (and UPnP) devices.
✓ AppDaemon 4¶
Python Apps and Dashboard using AppDaemon 4.x for Home Assistant
✓ Bitwarden RS¶
Open source password management solution
✓ Bookstack¶
Simple & Free Wiki Software
✓ Example¶
Example add-on by Community Home Assistant Add-ons
✓ FTP¶
A secure and fast FTP server for Home Assistant
✓ Folding@home¶
Fighting disease with a world wide distributed super computer
✓ Glances¶
A cross-platform system monitoring tool
✓ Grafana¶
The open platform for beautiful analytics and monitoring
✓ Grocy¶
ERP beyond your fridge! A groceries & household management solution for your home
✓ Home Panel¶
A web frontend for controlling the home
✓ InfluxDB¶
Scalable datastore for metrics, events, and real-time analytics
✓ JupyterLab¶
Create documents containing live code, equations, visualizations, and explanatory text
✓ Log Viewer¶
Browser-based log utility for Home Assistant
✓ Lutron Certificate¶
Generate certificate to control Lutron Caseta bridge locally
✓ MQTT Server & Web client¶
Mosquitto MQTT Server bundled with Hivemq's web client
✓ Matrix¶
A secure and decentralized communication platform.
✓ Mopidy¶
Mopidy is an extensible music server
✓ Network UPS Tools¶
Manage battery backup (UPS) devices
✓ Nginx Proxy Manager¶
Manage Nginx proxy hosts with a simple, powerful interface
✓ Node-RED¶
Flow-based programming for the Internet of Things
✓ Plex Media Server¶
Recorded media, live TV, online news, and podcasts ready to stream.
✓ Portainer¶
Manage your Docker environment with ease
✓ Prometheus¶
Cloud native metrics
✓ SQLite Web¶
Explore your SQLite database
✓ SSH & Web Terminal¶
SSH & Web Terminal access to your Home Assistant instance
✓ Spotify Connect¶
Play Spotify music on your Home Assistant device
✓ TasmoAdmin¶
Centrally manage all your Sonoff-Tasmota devices
✓ Tautulli¶
Monitoring and tracking tool for Plex Media Server
✓ The Lounge¶
A self-hosted web IRC client
Portainer Bitwarden_rs
✓ Tor¶
Protect your privacy and access Home Assistant via Tor.
✓ Traccar¶
Modern GPS Tracking Platform
✓ UniFi Controller¶
Manage your UniFi network using a web browser
✓ VSCode Remote¶
VSCode Remote access to Home Assistant
✓ Visual Studio Code¶
Fully featured VSCode experience, to edit your HA config in the browser, including auto-completion!
✓ WireGuard¶
Fast, modern, secure VPN tunnel
✓ Z-Wave JS to MQTT¶
Fully configurable Z-Wave JS to MQTT gateway and control panel
✓ Z-Wave to MQTT (DEPRECATED)¶
Fully configurable Z-Wave to MQTT gateway and control panel
✓ ZeroTier One¶
Radically simplify your network with a virtual networking layer that works the same everywhere
✓ chrony¶
A local NTP (Network Time Protocol) server for cameras etc.
✓ ledfx¶
A network based LED effect controller with support for advanced real-time audio effects!
✓ motionEye¶
Simple, elegant and feature-rich CCTV/NVR for your cameras
✓ phpMyAdmin¶
A web interface for the official MariaDB add-on
Releases¶
Add-on releases are NOT based on Semantic Versioning, unlikeall our other repositories. The latest build commit SHA hash of eachadd-on, represents the version number.
Support¶
Got questions?
You have several options to get them answered:
- The Home Assistant Community Add-ons Discord Chat Server
- The Home Assistant Community Forum.
- The Home Assistant Discord Chat Server.
- Join the Reddit subreddit in /r/homeassistant
Bitwarden Portainer
You could also open an issue here on GitHub. Note, we use a separateGitHub repository for each add-on. Please ensure you are creating the issueon the correct GitHub repository matching the add-on.
For a general repository issue or add-on ideas open an issue here
Contributing¶
This is an active open-source project. We are always open to people who want touse the code or contribute to it.
We have set up a separate document containing ourcontribution guidelines.
Thank you for being involved!
Adding a new add-on¶
We are currently not accepting third party add-ons to this repository.
For questions, please contact Franck Nijhof:
- Drop him an email: frenck@addons.community
- Chat with him on Discord Chat
- Message him via the forums: frenck
License¶
MIT License
Copyright © 2018-2021 Franck Nijhof
Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the 'Software'), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.