PersonalBusinessDownloadPricingHelpBlogContact
Get Started
Log In
HomePersonalBusinessDownloadPricingHelpBlogContactTalk to SalesGet StartedLog In

Self-hosting Families Sponsorships

If you're self-hosting a Bitwarden Enterprise Organization, you'll need to complete a short setup procedure to allow your users to redeem Families Organization sponsorships.

Step 1: Enable Cloud Communication

To allow your self-hosted Enterprise Organization to issue sponsorships for cloud Families Organizations, your server needs to communicate to our cloud systems which users are eligible for sponsorship.

note

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

Once you've set this value, apply your change by running the ./bitwarden.sh rebuild command.

tip

Self-hosting Families sponsorships requires communication with Bitwarden cloud systems. If your environment uses a firewall to block outbound traffic, you'll need to whitelist https://api.bitwarden.com and https://identity.bitwarden.com.

Step 2: Update your License

Before proceeding, update your self-hosted Organization license:

  1. Log in to the cloud Web Vault (https://vault.bitwarden.com) and navigate to your Organization's SettingsSubscription page.

  2. Select the Download License button.

  3. 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.

  4. Log in to your self-hosted Web Vault (for example, https://company.bitwarden.com) and navigate to your Organization's Settings Subscription page.

  5. Select the Update License button and upload the updated license.

Step 3: Setup Billing Sync

Once cloud communication is enabled at the server-level, a Sync Token needs to be passed from the cloud Organization you use for billing to your self-hosted Organization:

  1. Log in to the cloud Web Vault (https://vault.bitwarden.com) and navigate to your Organization's SettingsSubscription page.

  2. Scroll down to the Self-Hosting section and select the Set Up Billing Sync button.

  3. Enter your master password and select Generate Token.

  4. Copy the generated Billing Sync Token.

  5. Log in to your self-hosted Web Vault (for example, https://company.bitwarden.com) and navigate to your Organization's Settings Subscription page.

  6. Select the Manage Billing Sync button.

  7. Paste your generated Billing Sync Token and select Save.

Step 3: Trigger a Billing Sync

Once a user has requested sponsorship, they'll be allowed to use their sponsorship once a billing sync has occurred. Billing sync will occur once daily, however you can manually trigger a sync at any time. We encourage you to trigger a billing sync after setting up Billing Sync:

  1. Open your System Administrator Portal.

  2. Select the Organizations tab and open your Enterprise Organization.

  3. Scroll down to the Connections table and select the Manually Sync button in the Billing Sync entry.


Products

Resources

  • Resource Center
  • Community Forums
  • Security Compliance
  • Success Stories
  • User Reviews
  • Newsfeed
  • Subscribe to Updates

©2022 Bitwarden, Inc.

Terms Privacy Sitemap