Self-hosting Families Sponsorships
Members of enterprise organizations are offered a free Families organization sponsorship that can be applied to a new or pre-existing Families organization and redeemed directly from the web vault.
note
If you're looking for information on updating a license for a non-sponsored self-hosted Families organization, see here.
You will need to enable automatic billing sync to allow your self-hosted enterprise organization to issue sponsorships for cloud Families organizations. To set up automatic sync:
First, you'll need to configure your server to allow communication with our cloud systems.
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=trueText 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.
note
Enabling automatic sync requires communication 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.
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. To retrieve your sync token from the cloud web vault you must be an organization owner. To retrieve the token:
Open the cloud organization's Billing tab and select Subscription from the left menu.
Scroll down to the self-hosting section and select the Set up billing sync button.
Enter your master password and select Generate token.
Copy the generated token.
To apply the billing sync token to your self-hosted organization:
warning
At this stage, if you're upgrading your self-hosted deployment from an earlier version, you may need to manually update your license file before proceeding.
Open the self-hosted organization's Billing tab and select Subscription from the left menu.
In the License and billing management section, choose the Automatic sync option.
Select the Manage billing sync button.
Paste your generated Billing Sync Token and select Save.
note
The Last Sync in this section will report Never until syncing begins, which will occur once daily once you've triggered your first sync.
Trigger a sync once you've completed setup. Billing sync will occur once daily, however you can manually trigger a sync at any time. To trigger a sync:
Open the self-hosted organization's Billing tab and select Subscription from the left menu.
Select the Sync license button.
note
If you receive a version not supported error message, update your server and try uploading your license file again. To update your server, make a backup of the bwdata directory and follow these instructions.
In between syncs, users may see the status Awaiting Sync after redeeming or changing a sponsorship. This indicates your self-hosted Bitwarden server is waiting to sync with the Bitwarden cloud before a sponsorship can be fully redeemed or changed.