Skip to content

Update guidance on licensing cert #803

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
quexten wants to merge 5 commits into
base: main
Choose a base branch
from
+19 −13
Open

Update guidance on licensing cert #803

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8b66241
Update guidance on licensing cert
quexten May 4, 2026
0403b8d
Further cleanup
quexten May 4, 2026
1b8470c
Fix warning
quexten May 4, 2026
593d2c3
Apply feedback
quexten May 5, 2026
c1487c0
Update docs/getting-started/server/guide.md
quexten May 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 19 additions & 13 deletions docs/getting-started/server/guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -301,23 +301,29 @@ up-to-date. See [MSSQL Database](./database/mssql/index.md) for more information
## Install licensing certificate

To run your local server environment as a licensed instance, you will need to download the
`Licensing Certificate - Dev` from the shared Engineering collection and install it. This can be
done by double-clicking on the downloaded certificate.
`Licensing Certificate - Dev` from the shared Engineering collection.

:::note
1. Log in to your company-issued Bitwarden account
2. On the "Vaults" page, scroll down to the "Licensing Certificate - Dev" item
3. View attachments and only download `dev.pfx`
4. Create a `~/.secrets/` folder and place `dev.pfx` inside
5. Add the following under `globalSettings` in `secrets.json`, substituting your own path to
`dev.pfx` and the password from the "Licensing Certificate - Dev" vault item:

```json
"licenseCertificatePath": "/Users/<your name>/.secrets/dev.pfx",
"licenseCertificatePassword": "<password from the vault item>"
```

Mac users: When prompted to save the downloaded certificate and PFX file in Keychain Access be sure
to select "Default Keychain > login" from the dropdown otherwise they will not be found when
attempting to "Build and Run the Server".
6. Re-run `setup_secrets.ps1` to apply the new values to every server project — see
[Configure user secrets](#configure-user-secrets).

:::
:::warning

1. Log in to your company-issued Bitwarden account
2. On the "Vaults" page, scroll down to the "Licensing Certificate - Dev" item
3. View attachments and download both files
4. Go to Keychain Access and set the dev.cer certificate to "Always Trust"
5. The dev.pfx file will ask for a password. You can get this by clicking and opening the Licensing
Certificate - Dev item in the vault
Do not import the "Licensing Certificate - Dev" into your keychain. Doing so may compromise all TLS
traffic on your development machine.

:::

</Bitwarden>

Expand Down
Loading