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

Global virtual store

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

Global cache

How Bun stores and manages packages in its global cache

Isolated installs

Strict dependency isolation similar to pnpm's approach

On this page

Enabling Why it's fast Benchmarks Disk Real-world cold→warm Directory structure What stays project-local Peer dependencies Tradeoffs Phantom-dependency fallback node_modules is mostly symlinks Disk usage Concurrency Related documentation