# Generate a yarn-compatible lockfile (/docs/guides/install/yarnlock)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 290 · updated: 2026-07-28 -->
Related: [Add a dependency](/docs/guides/install/add.md), [Add a development dependency](/docs/guides/install/add-dev.md), [Add an optional dependency](/docs/guides/install/add-optional.md), [Add a peer dependency](/docs/guides/install/add-peer.md), [Add a Git dependency](/docs/guides/install/add-git.md), [Add a tarball dependency](/docs/guides/install/add-tarball.md)

<Note>
  Bun v1.1.39 introduced `bun.lock`, a JSONC-formatted lockfile. It is human-readable and git-diffable without
  configuration, at no cost to performance. In 1.2.0+ it is the default format for new projects. [**Learn
  more.**](/pm/lockfile#text-based-lockfile)
</Note>

***

Use the `--yarn` flag to generate a Yarn-compatible `yarn.lock` file (in addition to `bun.lock{b}`).

```sh terminal icon="terminal"
bun install --yarn
```

***

To set this as the default behavior, add the following to your `bunfig.toml` file.

```toml bunfig.toml icon="settings"
[install.lockfile]
print = "yarn"
```

***

To print a Yarn lockfile to your console without writing it to disk, "run" your `bun.lockb` with `bun`.

```sh terminal icon="terminal"
bun bun.lockb
```

```txt
# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
# yarn lockfile v1
# bun ./bun.lockb --hash: 9BFBF11D86084AAB-9418b03ff880c569-390CE6459EACEC9A...

abab@^2.0.6:
  version "2.0.6"
  resolved "https://registry.npmjs.org/abab/-/abab-2.0.6.tgz"
  integrity sha512-j2afSsaIENvHZN2B8GOpF566vZ5WVk5opAiMTvWgaQT8DkbOqsTfvNAvH...
```

***

See [`bun install`](/pm/cli/install).
