36 lines
1.0 KiB
Plaintext
36 lines
1.0 KiB
Plaintext
---
|
|
title: "Scopes and registries"
|
|
description: "Configure private registries and scoped packages"
|
|
---
|
|
|
|
The default registry is `registry.npmjs.org`. To change it globally, set it in `bunfig.toml`:
|
|
|
|
```toml bunfig.toml icon="settings"
|
|
[install]
|
|
# set default registry as a string
|
|
registry = "https://registry.npmjs.org"
|
|
# set a token
|
|
registry = { url = "https://registry.npmjs.org", token = "123456" }
|
|
# set a username/password
|
|
registry = "https://username:[email protected]"
|
|
```
|
|
|
|
To configure a private registry scoped to a particular organization:
|
|
|
|
```toml bunfig.toml icon="settings"
|
|
[install.scopes]
|
|
# registry as string
|
|
"@myorg1" = "https://username:[email protected]/"
|
|
|
|
# registry with username/password
|
|
# you can reference environment variables
|
|
"@myorg2" = { username = "myusername", password = "$NPM_PASS", url = "https://registry.myorg.com/" }
|
|
|
|
# registry with token
|
|
"@myorg3" = { token = "$npm_token", url = "https://registry.myorg.com/" }
|
|
```
|
|
|
|
### `.npmrc`
|
|
|
|
Bun also reads [`.npmrc`](/pm/npmrc) files.
|