Self-hosting

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 app by either an account with a premium individual subscription or by the owner of an organization.

The steps are different when working with an individual license versus an organization license.

note

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

Follow these procedures when working with an individual license for a premium subscription. You'll be working in both the cloud web vault and your self-hosted web vault, and your account email addresses should match.

Retrieve individual license

After you create an account on your self-hosted server, retrieve your license from the cloud web app:

  1. Log in and select SettingsSubscription from the navigation.

  2. Select the Download license button:

    Download personal license
    Download personal license

Apply individual license

Next, log in to your self-hosted Bitwarden server to apply the downloaded license:

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

  2. Select SettingsSubscription from the navigation.

  3. In the License file section, select the Browse... or Choose file button button and add the downloaded license file.

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

Update individual license

If for any reason you need to update your individual license file, for example when it expires:

  1. Follow the steps to Retrieve your license again.

  2. Follow the steps to Apply your license again, only this time you will see an Update license button rather than a button to browse for a new license.

Organization license

Follow these procedures when working with an organization license for a Families or Enterprise organization.

note

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

Retrieve organization license

Before starting an organization on your self-hosted server, retrieve your organization license from the cloud web app:

  1. In the Bitwarden web app, open the Admin Console using the product switcher:

    commutateur-de-produit
    commutateur-de-produit
  2. Navigate to BillingSubscription.

  3. Scroll down and 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.

note

Make sure that the installation ID you retrieved from bitwarden.com/host uses the same data region as where your organization exists.

Apply organization license

Applying your license in a self-hosted server is the means by which you'll create a self-hosted organization. From your self-hosted web vault:

  1. Start a new organization by selecting the Add organization button.

  2. Select the Browse... or Choose file button, add the downloaded license file, and select Submit.

note

Si vous recevez un message d'erreur indiquant que la version n'est pas prise en charge, mettez à jour votre serveur et essayez à nouveau de télécharger votre fichier de licence. Pour mettre à jour votre serveur, faites une sauvegarde du répertoire bwdata et suivez les instructions suivantes.

Update organization license

Organizations may need to update the license file on their self-hosted server, for example to add user seats or when your license expires. When your license expires and your organization renews, you have 60 days to apply the updated license file to your self-hosted organization.

There are two methods for doing so, however Families organizations may only update manually:

Automatic billing sync unlocks Families sponsorships (only for Enterprise) and simplified license updating, preventing admins from needing to manually re-upload licenses, for example in the case of organization renewal. To set up automatic sync:

note

To successfully setup Automatic Billing Sync, an active subscription license is required. If a self-hosted organization has been setup from a cloud hosted organization still in its trial period, a license will have to be downloaded and applied to the self-hosted organization once the trial period is over. Learn more about paid subscriptions here.

Step 1: Enable cloud communication

First, you'll need to configure your server to allow communication with our cloud systems.

note

Cette étape doit être réalisée par une personne ayant accès aux fichiers de configuration de votre instance auto-hébergée.

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

Bash
globalSettings__enableCloudCommunication=true

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

L'activation de la synchronisation automatique nécessite une communication avec les systèmes en nuage de Bitwarden. Si votre environnement utilise un pare-feu pour bloquer le trafic sortant, vous devrez autoriser https://api.bitwarden.com ou .eu et https://identity.bitwarden.com ou .eu.

Step 2: Retrieve billing sync token

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 app:

  1. Log in to the Bitwarden web app and open the Admin Console using the product switcher:

    commutateur-de-produit
    commutateur-de-produit
  2. Navigate to BillingSubscription.

  3. Scroll down to the self-hosting section and select the Set up billing sync button.

  4. Enter your master password and select Generate token.

  5. Copy the generated token.

Step 3: Apply billing sync token

To apply the billing sync token to your self-hosted organization:

  1. Open the self-hosted Admin Console and navigate to BillingSubscription.

  2. In the License and billing management section, choose the Automatic sync option.

  3. Select the Manage billing sync button.

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

note

La synchronisation pour Families for Enterprise se fera une fois par jour une fois que vous aurez déclenché votre première synchronisation. Le champ Dernière synchronisation de cette section indiquera Jamais jusqu'à ce que vous déclenchiez votre première synchronisation.

La synchronisation des mises à jour de licence doit toujours être effectuée manuellement en sélectionnant le bouton Synchroniser la licence (voir la section suivante pour plus de détails).

Step 4: Trigger sync

Trigger a sync once you've completed setup and each time you need to update your license. Sync for Familes for Enterprise will occur once daily. To trigger a sync:

  1. Open the self-hosted Admin Console and navigate to OrganizationBilling.

  2. Select the Sync license button.

note

Si vous recevez un message d'erreur indiquant que la version n'est pas prise en charge, mettez à jour votre serveur et essayez à nouveau de télécharger votre fichier de licence. Pour mettre à jour votre serveur, faites une sauvegarde du répertoire bwdata et suivez les instructions suivantes.

To manually re-upload a license file:

  1. Follow the steps to Retrieve your license again.

  2. Open the self-hosted Admin Console and navigate to BillingSubscription.

  3. In the License and billing management section, choose the Manual upload option.

  4. Select the Browse... or Choose file button to add your license file.

  5. Select Submit.

note

Si vous recevez un message d'erreur indiquant que la version n'est pas prise en charge, mettez à jour votre serveur et essayez à nouveau de télécharger votre fichier de licence. Pour mettre à jour votre serveur, faites une sauvegarde du répertoire bwdata et suivez les instructions suivantes.

Suggérer des modifications à cette page

Comment pouvons-nous améliorer cette page pour vous ?
Pour les questions techniques, de facturation et de produits, veuillez contacter le service d'assistance.

État du nuage

Vérifier l'état

Améliorez vos connaissances en cybersécurité.

Abonnez-vous à la newsletter.


© 2024 Bitwarden, Inc. Conditions Confidentialité Paramètres des cookies Plan du site

Go to EnglishStay Here