Get Started

Welcome to Bun Installation Quickstart TypeScript TypeScript 6 and 7

Watch Mode Debugging REPL bunfig.toml File Types Module Resolution JSX Auto-install Plugins File System Router

Cookies File I/O Streams Binary Data Archive SQL SQLite S3 Redis Workers Environment Variables Shell Spawn WebView Cron Node-API FFI C Compiler Transpiler CSRF Protection Secrets Console TOML YAML Markdown JSON5 JSONL HTMLRewriter Image Hashing Glob Semver Color Utils Globals Bun APIs Web APIs Node.js Compatibility

bunx Workspaces Catalogs bun --filter Global cache Global virtual store Isolated installs Lockfile Lifecycle scripts Scopes and registries Overrides and resolutions Security Scanner API .npmrc support

Advanced Configuration

Isolated installs

Strict dependency isolation similar to pnpm's approach

Global virtual store

Install packages once. Every project links to the same copy.

Lockfile

Bun's lockfile format and configuration

On this page

What are isolated installs?Key benefits Using isolated installs Command line Configuration file Default behavior How isolated installs work Directory structure Resolution algorithm Workspace handling Comparison with hoisted installs Advanced features Peer dependency handling Global virtual store Backend strategies Debugging isolated installs Troubleshooting Compatibility issues Performance considerations Migration guide From npm/Yarn From pnpm When to use isolated installs Related documentation