xoxys.vaultwarden_docker/index.md

---
title: bitwarden_rs
type: docs
---

[![Build Status](https://drone.rknet.org/api/badges/ansible/xoxys.bitwarden_rs/status.svg)](https://drone.rknet.org/ansible/xoxys.bitwarden_rs) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) 

Role to setup a [Bitwarden RS](https://github.com/dani-garcia/bitwarden_rs) passsword safe. Bitwarden_RS is a community Bitwarden API server implementation written in Rust. This Role use Docker to setup [Bitwarden](https://gitea.rknet.org/docker/bitwarden_rs) and a [Bitwarden LDAP](https://gitea.rknet.org/docker/bitwarden_rs_ldap) Sync Service (optional).

* [Default Variables](#default-variables)
  * [bitwardenrs_admin_token](#bitwardenrs-admin-token)
  * [bitwardenrs_authenticator_disable_time_drift](#bitwardenrs-authenticator-disable-time-drift)
  * [bitwardenrs_base_url](#bitwardenrs-base-url)
  * [bitwardenrs_cap_add](#bitwardenrs-cap-add)
  * [bitwardenrs_cap_drop](#bitwardenrs-cap-drop)
  * [bitwardenrs_container_name](#bitwardenrs-container-name)
  * [bitwardenrs_cpu_shares](#bitwardenrs-cpu-shares)
  * [bitwardenrs_db_name](#bitwardenrs-db-name)
  * [bitwardenrs_db_password](#bitwardenrs-db-password)
  * [bitwardenrs_db_port](#bitwardenrs-db-port)
  * [bitwardenrs_db_server](#bitwardenrs-db-server)
  * [bitwardenrs_db_ssl_mode](#bitwardenrs-db-ssl-mode)
  * [bitwardenrs_db_ssl_rootcert](#bitwardenrs-db-ssl-rootcert)
  * [bitwardenrs_db_user](#bitwardenrs-db-user)
  * [bitwardenrs_disable_2fa_remember](#bitwardenrs-disable-2fa-remember)
  * [bitwardenrs_disable_icon_download](#bitwardenrs-disable-icon-download)
  * [bitwardenrs_docker_compose_bin](#bitwardenrs-docker-compose-bin)
  * [bitwardenrs_exposed_ip](#bitwardenrs-exposed-ip)
  * [bitwardenrs_exposed_port](#bitwardenrs-exposed-port)
  * [bitwardenrs_extended_logging](#bitwardenrs-extended-logging)
  * [bitwardenrs_extra_hosts](#bitwardenrs-extra-hosts)
  * [bitwardenrs_healthcheck](#bitwardenrs-healthcheck)
  * [bitwardenrs_icon_blacklist_non_global_ips](#bitwardenrs-icon-blacklist-non-global-ips)
  * [bitwardenrs_icon_blacklist_regexl](#bitwardenrs-icon-blacklist-regexl)
  * [bitwardenrs_icon_cache_negttl](#bitwardenrs-icon-cache-negttl)
  * [bitwardenrs_icon_cache_ttl](#bitwardenrs-icon-cache-ttl)
  * [bitwardenrs_icon_download_timeout](#bitwardenrs-icon-download-timeout)
  * [bitwardenrs_image](#bitwardenrs-image)
  * [bitwardenrs_invitations_allowed](#bitwardenrs-invitations-allowed)
  * [bitwardenrs_ip_header](#bitwardenrs-ip-header)
  * [bitwardenrs_ldap_bind_dn](#bitwardenrs-ldap-bind-dn)
  * [bitwardenrs_ldap_bind_password](#bitwardenrs-ldap-bind-password)
  * [bitwardenrs_ldap_bitwarden_admin_token](#bitwardenrs-ldap-bitwarden-admin-token)
  * [bitwardenrs_ldap_bitwarden_url](#bitwardenrs-ldap-bitwarden-url)
  * [bitwardenrs_ldap_cap_add](#bitwardenrs-ldap-cap-add)
  * [bitwardenrs_ldap_cap_drop](#bitwardenrs-ldap-cap-drop)
  * [bitwardenrs_ldap_container_name](#bitwardenrs-ldap-container-name)
  * [bitwardenrs_ldap_cpu_shares](#bitwardenrs-ldap-cpu-shares)
  * [bitwardenrs_ldap_host](#bitwardenrs-ldap-host)
  * [bitwardenrs_ldap_image](#bitwardenrs-ldap-image)
  * [bitwardenrs_ldap_mail_field](#bitwardenrs-ldap-mail-field)
  * [bitwardenrs_ldap_memory_limit](#bitwardenrs-ldap-memory-limit)
  * [bitwardenrs_ldap_memory_reservation](#bitwardenrs-ldap-memory-reservation)
  * [bitwardenrs_ldap_pids_limit](#bitwardenrs-ldap-pids-limit)
  * [bitwardenrs_ldap_port](#bitwardenrs-ldap-port)
  * [bitwardenrs_ldap_restart_policy](#bitwardenrs-ldap-restart-policy)
  * [bitwardenrs_ldap_scheme](#bitwardenrs-ldap-scheme)
  * [bitwardenrs_ldap_search_base_dn](#bitwardenrs-ldap-search-base-dn)
  * [bitwardenrs_ldap_search_filter](#bitwardenrs-ldap-search-filter)
  * [bitwardenrs_ldap_security_opt](#bitwardenrs-ldap-security-opt)
  * [bitwardenrs_ldap_ssl](#bitwardenrs-ldap-ssl)
  * [bitwardenrs_ldap_sync_enabled](#bitwardenrs-ldap-sync-enabled)
  * [bitwardenrs_ldap_sync_interval_seconds](#bitwardenrs-ldap-sync-interval-seconds)
  * [bitwardenrs_ldap_sync_loop](#bitwardenrs-ldap-sync-loop)
  * [bitwardenrs_ldap_version](#bitwardenrs-ldap-version)
  * [bitwardenrs_ldap_volumes_extra](#bitwardenrs-ldap-volumes-extra)
  * [bitwardenrs_log_level](#bitwardenrs-log-level)
  * [bitwardenrs_memory_limit](#bitwardenrs-memory-limit)
  * [bitwardenrs_memory_reservation](#bitwardenrs-memory-reservation)
  * [bitwardenrs_password_iterations](#bitwardenrs-password-iterations)
  * [bitwardenrs_pids_limit](#bitwardenrs-pids-limit)
  * [bitwardenrs_reload_templates](#bitwardenrs-reload-templates)
  * [bitwardenrs_restart_policy](#bitwardenrs-restart-policy)
  * [bitwardenrs_security_opt](#bitwardenrs-security-opt)
  * [bitwardenrs_service_directory](#bitwardenrs-service-directory)
  * [bitwardenrs_show_password_hint](#bitwardenrs-show-password-hint)
  * [bitwardenrs_signups_allowed](#bitwardenrs-signups-allowed)
  * [bitwardenrs_signups_domains_whitelist](#bitwardenrs-signups-domains-whitelist)
  * [bitwardenrs_signups_verify](#bitwardenrs-signups-verify)
  * [bitwardenrs_signups_verify_resend_limit](#bitwardenrs-signups-verify-resend-limit)
  * [bitwardenrs_signups_verify_resend_time](#bitwardenrs-signups-verify-resend-time)
  * [bitwardenrs_smtp_auth_mechanism](#bitwardenrs-smtp-auth-mechanism)
  * [bitwardenrs_smtp_from](#bitwardenrs-smtp-from)
  * [bitwardenrs_smtp_from_name](#bitwardenrs-smtp-from-name)
  * [bitwardenrs_smtp_host](#bitwardenrs-smtp-host)
  * [bitwardenrs_smtp_password](#bitwardenrs-smtp-password)
  * [bitwardenrs_smtp_port](#bitwardenrs-smtp-port)
  * [bitwardenrs_smtp_ssl](#bitwardenrs-smtp-ssl)
  * [bitwardenrs_smtp_timeout](#bitwardenrs-smtp-timeout)
  * [bitwardenrs_smtp_username](#bitwardenrs-smtp-username)
  * [bitwardenrs_templates_folder](#bitwardenrs-templates-folder)
  * [bitwardenrs_version](#bitwardenrs-version)
  * [bitwardenrs_volumes_extra](#bitwardenrs-volumes-extra)
  * [bitwardenrs_web_vault_enabled](#bitwardenrs-web-vault-enabled)
  * [bitwardenrs_websocket_enabled](#bitwardenrs-websocket-enabled)
  * [bitwardenrs_websocket_exposed_ip](#bitwardenrs-websocket-exposed-ip)
  * [bitwardenrs_websocket_exposed_port](#bitwardenrs-websocket-exposed-port)
* [Dependencies](#dependencies)

---

## Default Variables

### bitwardenrs_admin_token

#### Default value

```YAML
bitwardenrs_admin_token: _unset_
```

### bitwardenrs_authenticator_disable_time_drift

#### Default value

```YAML
bitwardenrs_authenticator_disable_time_drift: false
```

### bitwardenrs_base_url

#### Default value

```YAML
bitwardenrs_base_url: http://localhost/
```

### bitwardenrs_cap_add

#### Default value

```YAML
bitwardenrs_cap_add: []
```

### bitwardenrs_cap_drop

#### Default value

```YAML
bitwardenrs_cap_drop: []
```

### bitwardenrs_container_name

#### Default value

```YAML
bitwardenrs_container_name: bitwardenrs
```

### bitwardenrs_cpu_shares

#### Default value

```YAML
bitwardenrs_cpu_shares: _unset_
```

#### Example usage

```YAML
bitwardenrs_cpu_shares: '1024'
```

### bitwardenrs_db_name

#### Default value

```YAML
bitwardenrs_db_name: bitwardenrs
```

### bitwardenrs_db_password

#### Default value

```YAML
bitwardenrs_db_password: secure
```

### bitwardenrs_db_port

#### Default value

```YAML
bitwardenrs_db_port: 5432
```

### bitwardenrs_db_server

This ansible roles does only support postgresql as database"

#### Default value

```YAML
bitwardenrs_db_server: localhost
```

### bitwardenrs_db_ssl_mode

#### Default value

```YAML
bitwardenrs_db_ssl_mode: disable
```

### bitwardenrs_db_ssl_rootcert

#### Default value

```YAML
bitwardenrs_db_ssl_rootcert: /etc/ssl/certs/ca-certificates.crt
```

### bitwardenrs_db_user

#### Default value

```YAML
bitwardenrs_db_user: pgbitwardenrs
```

### bitwardenrs_disable_2fa_remember

#### Default value

```YAML
bitwardenrs_disable_2fa_remember: false
```

### bitwardenrs_disable_icon_download

#### Default value

```YAML
bitwardenrs_disable_icon_download: false
```

### bitwardenrs_docker_compose_bin

#### Default value

```YAML
bitwardenrs_docker_compose_bin: /usr/local/bin/docker-compose
```

### bitwardenrs_exposed_ip

#### Default value

```YAML
bitwardenrs_exposed_ip: 127.0.0.1
```

### bitwardenrs_exposed_port

#### Default value

```YAML
bitwardenrs_exposed_port: 80
```

### bitwardenrs_extended_logging

#### Default value

```YAML
bitwardenrs_extended_logging: true
```

### bitwardenrs_extra_hosts

#### Default value

```YAML
bitwardenrs_extra_hosts: []
```

### bitwardenrs_healthcheck

#### Default value

```YAML
bitwardenrs_healthcheck:
  test: '["CMD", "/usr/local/bin/healthcheck.sh"]'
  interval: 10s
  timeout: 3s
  retries: 3
```

### bitwardenrs_icon_blacklist_non_global_ips

#### Default value

```YAML
bitwardenrs_icon_blacklist_non_global_ips: true
```

### bitwardenrs_icon_blacklist_regexl

#### Default value

```YAML
bitwardenrs_icon_blacklist_regexl: _unset_
```

### bitwardenrs_icon_cache_negttl

#### Default value

```YAML
bitwardenrs_icon_cache_negttl: '{{ bitwardenrs_icon_cache_ttl }}'
```

### bitwardenrs_icon_cache_ttl

#### Default value

```YAML
bitwardenrs_icon_cache_ttl: 2592000
```

### bitwardenrs_icon_download_timeout

#### Default value

```YAML
bitwardenrs_icon_download_timeout: 10
```

### bitwardenrs_image

#### Default value

```YAML
bitwardenrs_image: xoxys/bitwardenrs:{{ bitwardenrs_version }}
```

### bitwardenrs_invitations_allowed

#### Default value

```YAML
bitwardenrs_invitations_allowed: true
```

### bitwardenrs_ip_header

#### Default value

```YAML
bitwardenrs_ip_header: x-client-ip
```

### bitwardenrs_ldap_bind_dn

#### Default value

```YAML
bitwardenrs_ldap_bind_dn: _unset_
```

### bitwardenrs_ldap_bind_password

#### Default value

```YAML
bitwardenrs_ldap_bind_password: _unset_
```

### bitwardenrs_ldap_bitwarden_admin_token

#### Default value

```YAML
bitwardenrs_ldap_bitwarden_admin_token: "{{ bitwardenrs_admin_token | default('')\
  \ }}"
```

### bitwardenrs_ldap_bitwarden_url

#### Default value

```YAML
bitwardenrs_ldap_bitwarden_url: '{{ bitwardenrs_base_url }}'
```

### bitwardenrs_ldap_cap_add

#### Default value

```YAML
bitwardenrs_ldap_cap_add: []
```

### bitwardenrs_ldap_cap_drop

#### Default value

```YAML
bitwardenrs_ldap_cap_drop: []
```

### bitwardenrs_ldap_container_name

#### Default value

```YAML
bitwardenrs_ldap_container_name: bitwardenrs_ldap
```

### bitwardenrs_ldap_cpu_shares

#### Default value

```YAML
bitwardenrs_ldap_cpu_shares: _unset_
```

#### Example usage

```YAML
bitwardenrs_ldap_cpu_shares: '1024'
```

### bitwardenrs_ldap_host

#### Default value

```YAML
bitwardenrs_ldap_host: _unset_
```

### bitwardenrs_ldap_image

#### Default value

```YAML
bitwardenrs_ldap_image: xoxys/bitwardenrs_ldap:{{ bitwardenrs_ldap_version }}
```

### bitwardenrs_ldap_mail_field

#### Default value

```YAML
bitwardenrs_ldap_mail_field: mail
```

### bitwardenrs_ldap_memory_limit

#### Default value

```YAML
bitwardenrs_ldap_memory_limit: _unset_
```

#### Example usage

```YAML
bitwardenrs_ldap_memory_limit: 512m
```

### bitwardenrs_ldap_memory_reservation

#### Default value

```YAML
bitwardenrs_ldap_memory_reservation: _unset_
```

#### Example usage

```YAML
bitwardenrs_ldap_memory_reservation: 256m
```

### bitwardenrs_ldap_pids_limit

#### Default value

```YAML
bitwardenrs_ldap_pids_limit: _unset_
```

### bitwardenrs_ldap_port

#### Default value

```YAML
bitwardenrs_ldap_port: _unset_
```

### bitwardenrs_ldap_restart_policy

#### Default value

```YAML
bitwardenrs_ldap_restart_policy: on-failure
```

### bitwardenrs_ldap_scheme

#### Default value

```YAML
bitwardenrs_ldap_scheme: _unset_
```

### bitwardenrs_ldap_search_base_dn

#### Default value

```YAML
bitwardenrs_ldap_search_base_dn: _unset_
```

### bitwardenrs_ldap_search_filter

#### Default value

```YAML
bitwardenrs_ldap_search_filter: (&(objectclass=*)(uid=*))
```

### bitwardenrs_ldap_security_opt

#### Default value

```YAML
bitwardenrs_ldap_security_opt: []
```

### bitwardenrs_ldap_ssl

#### Default value

```YAML
bitwardenrs_ldap_ssl: true
```

### bitwardenrs_ldap_sync_enabled

#### Default value

```YAML
bitwardenrs_ldap_sync_enabled: false
```

### bitwardenrs_ldap_sync_interval_seconds

#### Default value

```YAML
bitwardenrs_ldap_sync_interval_seconds: 60
```

### bitwardenrs_ldap_sync_loop

#### Default value

```YAML
bitwardenrs_ldap_sync_loop: true
```

### bitwardenrs_ldap_version

#### Default value

```YAML
bitwardenrs_ldap_version: latest
```

### bitwardenrs_ldap_volumes_extra

#### Default value

```YAML
bitwardenrs_ldap_volumes_extra: []
```

#### Example usage

```YAML
bitwardenrs_ldap_volumes_extra:
  - /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:Z
```

### bitwardenrs_log_level

#### Default value

```YAML
bitwardenrs_log_level: Info
```

### bitwardenrs_memory_limit

#### Default value

```YAML
bitwardenrs_memory_limit: _unset_
```

#### Example usage

```YAML
bitwardenrs_memory_limit: 512m
```

### bitwardenrs_memory_reservation

#### Default value

```YAML
bitwardenrs_memory_reservation: _unset_
```

#### Example usage

```YAML
bitwardenrs_memory_reservation: 256m
```

### bitwardenrs_password_iterations

#### Default value

```YAML
bitwardenrs_password_iterations: 100000
```

### bitwardenrs_pids_limit

#### Default value

```YAML
bitwardenrs_pids_limit: _unset_
```

### bitwardenrs_reload_templates

#### Default value

```YAML
bitwardenrs_reload_templates: false
```

### bitwardenrs_restart_policy

#### Default value

```YAML
bitwardenrs_restart_policy: on-failure
```

### bitwardenrs_security_opt

#### Default value

```YAML
bitwardenrs_security_opt: []
```

### bitwardenrs_service_directory

#### Default value

```YAML
bitwardenrs_service_directory: /var/lib/docker/services/bitwardenrs
```

### bitwardenrs_show_password_hint

#### Default value

```YAML
bitwardenrs_show_password_hint: true
```

### bitwardenrs_signups_allowed

#### Default value

```YAML
bitwardenrs_signups_allowed: false
```

### bitwardenrs_signups_domains_whitelist

#### Default value

```YAML
bitwardenrs_signups_domains_whitelist: _unset_
```

### bitwardenrs_signups_verify

#### Default value

```YAML
bitwardenrs_signups_verify: false
```

### bitwardenrs_signups_verify_resend_limit

#### Default value

```YAML
bitwardenrs_signups_verify_resend_limit: 6
```

### bitwardenrs_signups_verify_resend_time

#### Default value

```YAML
bitwardenrs_signups_verify_resend_time: 3600
```

### bitwardenrs_smtp_auth_mechanism

#### Default value

```YAML
bitwardenrs_smtp_auth_mechanism: plain
```

### bitwardenrs_smtp_from

#### Default value

```YAML
bitwardenrs_smtp_from: bitwardenrs@localhost
```

### bitwardenrs_smtp_from_name

#### Default value

```YAML
bitwardenrs_smtp_from_name: bitwarden_rs
```

### bitwardenrs_smtp_host

#### Default value

```YAML
bitwardenrs_smtp_host: _unset_
```

### bitwardenrs_smtp_password

#### Default value

```YAML
bitwardenrs_smtp_password: _unset_
```

### bitwardenrs_smtp_port

#### Default value

```YAML
bitwardenrs_smtp_port: 587
```

### bitwardenrs_smtp_ssl

#### Default value

```YAML
bitwardenrs_smtp_ssl: true
```

### bitwardenrs_smtp_timeout

#### Default value

```YAML
bitwardenrs_smtp_timeout: 15
```

### bitwardenrs_smtp_username

#### Default value

```YAML
bitwardenrs_smtp_username: _unset_
```

### bitwardenrs_templates_folder

#### Default value

```YAML
bitwardenrs_templates_folder: _unset_
```

### bitwardenrs_version

#### Default value

```YAML
bitwardenrs_version: latest
```

### bitwardenrs_volumes_extra

#### Default value

```YAML
bitwardenrs_volumes_extra: []
```

#### Example usage

```YAML
bitwardenrs_volumes_extra:
  - /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:Z
```

### bitwardenrs_web_vault_enabled

#### Default value

```YAML
bitwardenrs_web_vault_enabled: true
```

### bitwardenrs_websocket_enabled

#### Default value

```YAML
bitwardenrs_websocket_enabled: false
```

### bitwardenrs_websocket_exposed_ip

#### Default value

```YAML
bitwardenrs_websocket_exposed_ip: 127.0.0.1
```

### bitwardenrs_websocket_exposed_port

#### Default value

```YAML
bitwardenrs_websocket_exposed_port: 3012
```

## Dependencies

None.