VK Cloud logo

Bitwarden Deployment

Bitwarden is an enterprise password manager that provides secure storage and collaborative management of credentials and secrets.

Bitwarden features:

  • Secure storage of passwords and secrets: a centralized repository of encrypted accounts, API keys, and other sensitive data in VK Cloud.
  • Access and permission management: configuration of a role-based access model for employees.
  • Generation of strong passwords: creation of unique complex passwords for each account.
  • Autofill and synchronization: browser extensions and mobile applications, automatic insertion of logins and passwords.
  • Auditing and reports: logging of account logins, password changes, and other user actions.
  • Collaboration with secrets: secure sharing of credentials and secrets between teams and projects.

By using the Bitwarden service, you agree to the license agreements of Marketplace VK Cloud and Bitwarden.

To deploy the Bitwarden service on a VM in your VK Cloud project:

  1. Request an installation ID and key on the official Bitwarden page. In the request, specify the email address to which you want to receive notifications from Bitwarden and the EU region.

  2. Register and go to the VK Cloud management console.

  3. To have access to the VM with the deployed service and to the Bitwarden web interface from the Internet:

    1. Create a network with Internet access if it has not been created earlier.
    2. In the subnet settings, where the VM with the deployed service will be located, disable the Private DNS option.
  4. Go to the App Store section.

  5. Click on the Bitwarden service card.

    If there is no Bitwarden service card on the page, click the All solutions button and find the card in the catalog.

  6. Click on the Bitwarden service card.

  7. On the Service description tab, click the Connect button.

  8. On the Plan tab, select the service version from the list.

  9. Choose a suitable plan: Basic or Advanced.

    Designed for quick service launch with minimal settings.

    Features:

    • User registration via the web interface.
    • Ability to disable registration of new users (via the Prohibit user registration via Web UI option).

    Suitable for personal use, small teams, or testing without the need for centralized management.

  10. Enter the data on the Server parameters page.

    1. Specify the Bitwarden parameters:

      • How Bitwarden will be hosted: select the service hosting type.

        • external — with an external IP address and a domain name provided by VK Cloud. Choose this hosting type to access the VM with the deployed Bitwarden service from the Internet.
        • internal — with access only within VK Cloud.
      • Enable S3 backup: enable the option to create daily backups of Bitwarden data in the VK Cloud object storage. The storage is created automatically. The last 7 copies are retained.

      • INSTALLATION ID: specify the installation ID obtained on the official Bitwarden website.

      • INSTALLATION KEY: specify the installation key obtained on the official Bitwarden website.

      • Prohibit user registration via Web UI: disable the option to avoid blocking Bitwarden user registration at the first service launch after installation. You can enable this option later.

      • Enable monitoring: enable the option to automatically send metrics of the virtual machine where Bitwarden is deployed to the Cloud Monitoring service. These metrics will be available in the Monitoring section of the management console.

    2. Specify the parameters of the virtual machine where the service instance will be deployed:

      • Network: select the network where the VM with the deployed service will be located. If you specified the external hosting type, select a network with Internet access and a subnet for which the Private DNS option is disabled.
      • Availability zone: select the availability zone where the VM will run.
      • Virtual machine type: select a preset VM configuration.
    3. Specify the parameters of the system disk and the data disk.

      • Disk size: specify the required VM disk size in gigabytes.
      • Disk type: select one of the disk types — HDD, SSD, or High-IOPS SSD.
  11. Click the Next step button.

  12. If you selected the Advanced plan, specify the advanced service parameters:

    • SMTP User: specify the user on behalf of whom emails will be sent to Bitwarden users.
    • SMTP Password: specify the password of the user on behalf of whom emails will be sent to Bitwarden users.
    • SMTP Host: specify the address of the SMTP server from which emails will be sent, for example smtp.gmail.com.
    • SMTP Port: specify the SMTP server port in accordance with the documentation of your SMTP provider, for example 587.
    • SMTP SSL: enable or disable the option in accordance with the documentation of your SMTP provider.
    • Administration: specify, separated by commas, the email addresses of users who will be allowed to manage the Bitwarden service.

    SMTP settings can be obtained from your provider.

  13. Review the cost of the infrastructure for deploying the service and click the Connect plan button.

    The cloud infrastructure deployment will begin, and the service properties page will open. The process status will also be displayed in the App Store → My services section.

    After a successful deployment, messages will be sent to the email address linked to your VK Cloud account:

    • a notification with a link to the service instance in the VK Cloud management console;
    • an email with a one-time link to the service access details.
  14. Follow the one-time link from the email and save the service access details:

    • bitwarden_admin_url — the link for accessing the Bitwarden web interface.
    • bitwarden_db_pass — the password for accessing the Bitwarden database that stores the service's service information (user profile data, organization composition, settings, event logs).
    • os_service_user — the login for running and managing the Bitwarden service on the VM with the deployed service instance.
    • bitwarden_os_service_user_pass — the password for connecting to os_service_user.
    • os_user — the login for connecting via SSH to the VM where the service instance is deployed, since according to the Bitwarden security policy the default login (ubuntu) cannot be used. This may be needed for operating system updates, firewall configuration, monitoring, and other administration tasks on the VM with the deployed service.
    • keypair — the private SSH key for connecting to the VM where the service instance is deployed.
  15. Use the appropriate option for the first login to the Bitwarden web interface after the service installation:

    1. Make sure that the Prohibit user registration via Web UI option is disabled in the settings of your Bitwarden service instance:

      1. In the VK Cloud management console, go to the App Store → My services section.
      2. Click on the name of your Bitwarden service instance.
      3. Go to the Plans tab and click the Configure plan button.
      4. Disable the Prohibit user registration via Web UI option if it is enabled, and save the changes.
    2. Follow the link from bitwarden_admin_url.

    3. Click the button for creating a new account.

    4. Specify the email and the master password.

  16. Configure the prohibition of user registration via the Web UI for the deployed Bitwarden service instance:

    1. In the VK Cloud management console, go to the App Store → My services section.
    2. Click on the name of your Bitwarden service instance.
    3. Go to the Plans tab and click the Configure plan button.
    4. Enable the Prohibit user registration via Web UI option and save the changes.
  17. (Optional) Use the official Bitwarden documentation to start working with the service.

Was this article helpful?