2、导航到**计费** → **订阅**。
3、滚动到最下面然后选择**下载许可证**按钮。
4、提示时，输入安装自托管服务器时使用的安装 ID 然后选择**提交**。如果您不知道安装 ID，可以从 `./bwdata/env/global.override.env` 获取。
{% hint style="info" %}
确保您从 [bitwarden.com/host](https://bitwarden.com/host/) 获取的安装 ID 使用的[数据区域](/docs/security/server-geographies.md)与您的组织所在的数据区域相同。
{% endhint %}
### 应用组织许可证
在自托管服务器中应用您的许可证意味着您将要创建一个自托管组织。从您的自托管网页密码库：
1. 通过选择 **🞤新增组织**以在您的自托管实例中创建一个新的组织。
2. 选择**浏览...**或**选择文件**按钮，添加已下载的许可证文件，然后选择**提交**。
{% hint style="info" %}
如果您收到一条 `version not supported`（版本不支持）的错误消息，请更新您的服务器并尝试再次上传您的许可证文件。要更新您的服务器，请备份 `bwdata` 目录，然后按照[这些说明](/docs/self-hosting/update-a-server.md)进行操作。
{% endhint %}
### 更新组织许可证
在几种不同的情况下，组织需要更新其自托管服务器使用的许可证文件，例如：
* 要**添加用户席位**到自托管组织。自托管组织的席位数由许可证决定，因此要添加席位，必须首先将其添加到关联的云组织，然后必须更新自托管组织使用的许可证。
* 要**在许可证续订后**继续运营自托管组织。自续订之日起，您有 60 天的时间将许可证文件更新到您的自托管服务器，否则您的自托管[组织将被禁用](/docs/plans-and-pricing/organization-renewal.md)。
有两种方法可以更新自托管组织的许可证，但是**家庭组织只能手动更新**：
{% tabs %}
{% tab title="自动同步" %}
自动同步：
* 组织管理员无需手动重新上传许可证。设置完成后，管理员只需在需要更新自托管组织使用的许可证时从**组织** → **计费**触发同步。
* 使[家庭赞助](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-members.md)计划对自托管组织的成员成为可能。此类赞助的同步每天会自动进行。
* 仍在免费试用期内的组织无法设置此功能。
要设置自动同步：
### 第 1 步：启用云端通信
{% hint style="info" %}
此步骤必须由对您的自托管实例的配置文件具有访问权限的人员完成。
{% endhint %}
首先，将 `bwdata/env/global.override.env` 中的以下行设置为 `true`，以将您的服务器配置为允许与 Bitwarden 云系统通信：
```systemd
globalSettings__enableCloudCommunication=true
```
设置此值后，运行 `./bitwarden.sh rebuild` 命令以应用您的更改。使用 `./bitwarden.sh start` 命令重启您的服务器。
{% hint style="info" %}
启用自动同步需要与 Bitwarden 的云端系统进行通信。如果您的环境使用防火墙阻止了出站流量，则需要允许 `https://api.bitwarden.com` 或 `https://api.bitwarden.eu` 和 `https://identity.bitwarden.com` 或 `https://identity.bitwarden.eu`。
{% endhint %}
### 第 2 步：获取计费同步令牌
在服务器层面启用云端通信后，需要将同步令牌从用于计费的云端组织传递到您的自托管组织。要从云端 App 获取您的同步令牌：
1、打开**云端**管理控制台，然后导航到**计费** → **订阅**。
2、在「自托管」部分，选择**设置计费同步**。
3、输入主密码然后选择**生成令牌**。
4、复制生成的令牌。
### 第 3 步：应用计费同步令牌
要将计费同步令牌应用到您的自托管组织：
1、打开**自托管**管理控制台，然后导航到**计费** → **订阅**。
2、在「许可证和计费管理」部分，选择**自动同步**选项。
3、选择**管理计费同步**按钮。
4、粘贴您生成的**计费同步令牌**然后选择**保存**。
{% hint style="info" %}
触发第一次同步后，[企业版家庭](https://help.ppgg.in/self-hosting/self-hosting-families-sponsorships)将每天同步一次。在您触发第一次同步之前，本部分中的**上次同步**字段将报告为**从不**。
用于许可证更新的同步必须始终通过选择**同步许可证**按钮来手动完成（详情请参阅下一部分）。
{% endhint %}
### 第 4 步：触发同步
完成设置后以及**每次需要更新许可证时**都需要触发同步。企业版家庭将**每天**同步一次。要触发同步：
1. 打开**自托管**管理控制台，然后导航到**组织** → **计费**。
2. 选择**同步许可证**按钮。
{% hint style="info" %}
如果您收到一条 `version not supported`（版本不支持）的错误消息，请更新您的服务器并尝试再次上传您的许可证文件。要更新您的服务器，请备份 `bwdata` 目录，然后按照[这些说明](https://help.ppgg.in/self-hosting/update-your-instance)进行操作。
{% endhint %}
{% endtab %}
{% tab title="手动更新" %}
要手动重新上传许可证文件：
1. 按照步骤再次**获取您的许可证**。
2. 打开自托管的管理控制台，然后导航到**计费** → **订阅**。
3. 在「许可证和计费管理」部分，选择**手动上传**选项。
4. 选择**浏览...**或**选择文件**按钮以添加您的许可证文件。
5. 选择**提交**。
{% hint style="info" %}
如果您收到一条 `version not supported`（版本不支持）的错误消息，请更新您的服务器并尝试再次上传您的许可证文件。要更新您的服务器，请备份 `bwdata` 目录，然后按照[这些说明](https://help.ppgg.in/self-hosting/update-your-instance)进行操作。
{% endhint %}
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.ppgg.in/docs/self-hosting/licensing-on-premise.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
