# Bitwarden Secure Sync

Bitwarden Secure Sync is a local backup tool for Bitwarden users that periodically exports their vault to a local file using the Bitwarden CLI. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1703/bitwarden-secure-sync

## Description

Bitwarden Secure Sync is a local backup tool for Bitwarden users that periodically exports their vault to a local file using the Bitwarden CLI.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 5 of 5 factors.
- Maintained: 59 (last commit 168 days ago)
- Popular: 27 (22 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 75 (no serious findings)

## Links

- Docker Hub: https://hub.docker.com/r/aronmarinelli/bitwarden-secure-sync/
- GitHub: https://github.com/AronMarinelli/bitwarden-secure-sync
- Unraid: https://ca.unraid.net/apps/bitwarden-secure-sync-1id8a8v1ojh1gz?q=bitwarden-secure-sync

## Common questions

### Which folders must I bind when running the Docker image?

Bind both the /app/config and /app/data directories to host paths for the container to function properly. On first run the app creates appsettings.json in /app/config.

### Should I run the container as root?

The app defaults to running as root, so the docs recommend setting the PUID and PGID environment variables for better security. You can pass them with the Docker run command along with the config and data volumes.

### Which Bitwarden credentials do I put in the config?

Use the API ClientId and ClientSecret from the security keys area of your Bitwarden account settings. The config also needs the server URL and your vault password.

### Where are exported vault files stored and how long are they kept?

Exports go to the data directory, which can be set with DataDirectory in appsettings.json. FileRetention controls how many days export files are kept, with the example using 7 days.

### Can I run this without Docker?

Yes, you can clone the repository and build the .NET console app yourself. You need an appsettings.json file in the working directory or in a config subdirectory.

---
Source: Our Local Host (https://ourlocalhost.com/app/1703/bitwarden-secure-sync), the self-hosted and open-source app directory.
