Bitwarden selfhost license renew

1

以下流程以 Bitwarden 2024 之後的「Unified」映像檔（docker-compose）與傳統 bitwarden.sh 腳本都適用；請依自己環境挑選對應做法。
（以下指令均在 bwdata/ 目錄或與之等效的 Compose 資料夾中執行）

1 │ 先確定「續約檔」已在手上

  1. 登入 Bitwarden 雲端後台 → Admin Console → Billing → Subscription。
  2. 點 Download license，系統會要求輸入 Installation ID。
  3. 下載得到最新的 license.json（或 license.lic）檔案。(bitwarden.com)

續約後有 60 天寬限期 可以替換檔案，逾期付費功能才會停用。(bitwarden.com)

2 │ 找回（或重新申請）Installation ID / Key

找回現有 ID

伺服器上有舊安裝時，直接開啟

bwdata/env/global.override.env

即可看到 globalSettings__installation__id= 與 ...key= 兩行。(reddit.com)

若遺失／搬家需要新 ID

到官方表單填信箱就能重新申請一組新的 Installation ID / Key。(bitwarden.com)

一台伺服器建議只用一組 ID/Key；若改用新組，記得下一步一起更新。

3 │ 把新 License 套到自架伺服器

版本 操作介面 步驟
Unified (docker-compose) Web Admin (https://<你的域名>/admin) 1. 以站長帳號登入
2. Admin Console → Billing → Subscription
3. 在「License and billing management」選 Manual upload → 選檔上傳 license.json → Submit
CLI bash docker cp license.json bitwarden:/etc/bitwarden/license.lic docker compose restart bitwarden
傳統腳本 (bitwarden.sh) CLI bash cp license.json bwdata/core/license.json ./bitwarden.sh apply # 或 ./bitwarden.sh restart
同時更換 Installation ID / Key CLI 1. 編輯 bwdata/env/global.override.env，更新兩行
2. bash ./bitwarden.sh rebuild && ./bitwarden.sh restart

執行 apply/restart／Compose restart 後，系統會在 1-2 分鐘內重新載入授權。

4 │ 驗證續約是否成功

  1. 重新整理 Web Vault，進入 Admin Console → Billing → Subscription。
  2. 確認 Expiration Date 已更新到下一年；若仍顯示舊日期，可再點一次 Sync license 或重啟容器。(bitwarden.com)

5 │ 想少動手？啟用自動同步

在 global.override.env 加上

globalSettings__enableCloudCommunication=true

之後執行 rebuild，再到 Admin Console 設定 Automatic sync，日後就不用手動上傳檔案，只要按一下 Sync license 即可。(bitwarden.com)

常見錯誤排除

情況 解法
Version not supported 先 ./bitwarden.sh updateself && ./bitwarden.sh update（或 docker pull + compose up -d）升級伺服器，再重新上傳 license。
Invalid Installation ID 確認下載 license 時填的 ID 與 global.override.env 內一致；若改用新 ID/Key，記得同檔案一起修改。
上傳後功能仍鎖定 確認自己登入的是「組織」而非個人保險箱；企業版功能只在組織範疇生效。

照以上步驟即可完成 Bitwarden 自架版的續約與授權更新，確保企業功能不中斷。若仍有疑問，可回報具體日誌訊息協助診斷。祝更新順利！