Runtime
Bundler
Package Manager
Test Runner
Guides
Reference
Blog
Install Bun
Guides Package Manager

Configure a private registry for an organization scope with bun install

Private registries can be configured using either .npmrc or bunfig.toml. While both are supported, we recommend using bunfig.toml for enhanced flexibility and Bun-specific options.

To configure a registry for a particular npm scope:

bunfig.toml
[install.scopes]
# as a string
"@myorg1" = "https://usertitle:password@registry.myorg.com/"

# as an object with username/password
# you can reference environment variables
"@myorg2" = {
  username = "myusername",
  password = "$npm_pass",
  url = "https://registry.myorg.com/"
}

# as an object with token
"@myorg3" = { token = "$npm_token", url = "https://registry.myorg.com/" }

Your bunfig.toml can reference environment variables. Bun automatically loads environment variables from .env.local, .env.[NODE_ENV], and .env. See Docs > Environment variables for more information.

bunfig.toml
[install.scopes]
"@myorg3" = { token = "$npm_token", url = "https://registry.myorg.com/" }

See Docs > Package manager for complete documentation of Bun's package manager.

On this page

No Headings