Bitwarden selfhost license renew

以下流程以 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 自架版的續約與授權更新,確保企業功能不中斷。若仍有疑問,可回報具體日誌訊息協助診斷。祝更新順利!