License Paid Features

Self-hosting Bitwarden is free, however some features must be unlocked in your self-hosted instance with a registered license file. A license file can be obtained from the Bitwarden-hosted web vault by either an account with a premium individual subscription or by the owner of an organization.

備考

The procedures in this article assume that you have already started a paid subscription to Bitwarden. If you haven't, refer to About Bitwarden plans and What plan is right for me?

Individual license

To retrieve your license from your cloud account and apply it to your self-hosted server:

Retrieve your license

  1. Log in to your web vault, select the profile icon, and choose Account Settings from the dropdown:

    Account Settings |
    Account Settings

  2. Select Subscription from the Account Settings menu.

  3. Select the Download License button.

Apply your license

  1. Log in to your self-hosted web vault with an email address that matches the cloud-hosted account from which you downloaded the license.

    tip

    If you haven't already, verify your email address before proceeding. You will need to have configured SMTP-related environment variables to do so.

  2. Select the profile icon and choose Account Settings from the dropdown.

  3. Select Subscription from the Account Settings menu.

  4. In the License File section, select the Browse... button and add the downloaded license file.

  5. Select the Submit button to apply your premium license.

Organization license

To retrieve your organization license from your cloud organization and apply it to your self-hosted server:

備考

You must be an organization owner to both retrieve and apply a license.

Enable cloud communication

If you intend to use billing sync, your server needs to communicate with our cloud systems.

備考

This step must be completed by someone with access to your self-hosted instance's configuration files.

In order to enable cloud communication, set the following line in bwdata/env/global.override.env to true:

globalSettings__enableCloudCommunication=true
Text Copied!

Once you have set this value, apply your change by running the ./bitwarden.sh rebuild command. Start your server again with the ./bitwarden.sh start command.

備考

Enabling billing sync for enterprise or self-hosting families sponsorships requies comunication with Bitwarden's cloud systems. If your environment uses a firewall to block outbound traffic, you will need to allow https://api.bitwarden.com and https://identity.bitwarden.com.

Retrieve your license

  1. In the cloud web vault, open your organization.

  2. Select the organization Billing tab and select Subscription from the left menu.

  3. Select the Download License button.

  4. When prompted, enter the installation ID that was used to install your self-hosted server and select Submit.

    If you don't know the installation ID off-hand, you can retrieve it from ./bwdata/env/global.override.env.

Apply your license

  1. Log in to your self-hosted web vault.

  2. Start a new organization by selecting the Add Organization button.

  3. When prompted, upload the organization license file and select Submit.

備考

If you receive a version not supported error message, update your server and try uploading your organization license file again. To update your server, make a backup of the bwdata directory and follow these instructions.

Update a renewed organization license

When your license expires and your organization renews, you have two months to apply the updated license file to your self-hosted organization. Enabling automatic license sync will automate this process for Enterprise Organizations. License sync will also allow any user seat or subscription changes to be quickly applied to your self-hosted server by pressing the License sync button.

To enable automatic sync for Enterprise:

  1. Open your organization on the cloud web vault.

  2. Select the organization Billing tab and select Subscription from the left menu.

  3. Select the Set up billing sync button. You will be prompted to enter your Master password.

  4. Copy the Billing sync token. Next, open your self-hosted web vault and navigate to the BillingSubscription page of your organization.

  5. Choose the Automatic sync option and select Manage billing sync. Paste the copied Billing sync token and Save. Once this has been completed, the Sync license button will appear, allowing you to trigger a license sync at any time.

    Enable auto sync |
    Enable auto sync

  6. Any time an update is made to user seats or billing, press Sync license and your self-hosted organization will update accordingly.

備考

Manual license uploads will remain available for Families plans, and users who do not wish to use automatic syncing. To manually update a license file:

  1. Download the new license file (Steps 1-3 above) from the cloud-hosted Bitwarden organization vault.

  2. Once downloaded, open your self-hosted web vault and update the license from the organization BillingSubscription page:

Update your license |
Update your license

If you receive a version not supported error message, you will need to update your server before proceeding. Make a backup or copy of the bwdata directory, then follow these instructions.


© 2023 Bitwarden, Inc.
利用規約プライバシーポリシーサイトマップ