Setting your Bun Version

To include Bun in your service's environment, you must do at least one of the following:

• Set your service's Bun version using one of the methods below.
• Include a bun.lock or bun.lockb file in your service's root directory.

Otherwise, your service's environment will not include Bun.

Set your service's Bun version in any of the following ways (in descending order of precedence):

1. Set the BUN_VERSION environment variable for your service in the Render Dashboard:

   

2. Add a file named .bun-version to the root of your repo. This file contains a single line with the version to use:

Supported version values

Using latest or canary might introduce breaking changes in your service.

• Because these versions change over time, a future release might be incompatible with your service's code or configuration.
• Never use canary for a production service. Canary builds are untested pre-releases.
  • Instead, use canary in non-production services to preview upcoming Bun changes.

History of default Bun versions

If you don't set a Bun version for your service, Render's default version depends on when you originally created the service: