Support for Bun lands in Laravel Sail and Forge

Published on by

Support for Bun lands in Laravel Sail and Forge image

Both Laravel Sail and Laravel Forge now includes support for Bun, a fast all-in-one JavaScript runtime. Once you update Sail, you can start Bun as follows:

sail bun run ... # Run a `bun` command
sail bunx ... # Run a `bunx` command

Bun is a new all-in-one toolkit for JavaScript and TypeScript apps that ships with a single executable, aptly named bun. Like npx, the bunx runs an NPM package executable and automatically installs the package to a global shared cache if not installed in node_modules.

Let's look at how we can use bun with Sail or any Laravel project.

Using Bun in Your Laravel Project

To start using Bun with Laravel, you'll first want to remove the existing package-lock file. For example, if you're using npm, you'll want to run the following:

# Remove package-lock.json
git rm package-lock.json
git commit -m"Remove package-lock.json" package-lock.json
# Install dependencies with bun
sail bun install
[1.30ms] ".env"
bun install v1.0.0 (822a00c4)
Checked 20 installs across 43 packages (no changes) [41.00ms]

After the bun install succeeds, you can version the lock file:

git add bun.lockb
git commit -m"Install Bun" bun.lockb

Install Packages with Bun

You can also use the bun install command to add new dependencies. Let's say you want to install the laravel-precognition-vue package with Laravel Precognition:

$ sail bun install laravel-precognition-vue
[1.05ms] ".env"
bun add v1.0.0 (822a00c4)
installed laravel-precognition-vue@0.5.1
9 packages installed [1.57s]

The build and dev command with Vite

You can use bun to run the build command that builds Vite dependencies for production:

$ sail bun run build
$ vite build
vite v4.4.9 building for production...
✓ 46 modules transformed.
public/build/manifest.json 0.25 kB │ gzip: 0.13 kB
public/build/assets/app-4ed993c7.js 0.00 kB │ gzip: 0.02 kB
public/build/assets/app-dbe23e4c.js 29.10 kB │ gzip: 11.64 kB
✓ built in 1.07s

For your development workflow, you can run the dev command the same way:

sail bun run dev

Updating Sail

To get the latest version of Laravel Sail in your existing application, update Sail via composer:

composer update larvel/sail
git add composer.lock
git commit -m"Update sail" composer.json
# Build the latest Docker images
sail down
sail build --pull
sail up -d

Once you've built the latest version of Sail, you can verify that bun is installed with the following:

sail bun --version

Hat tip to Dmytro Morozov, who contributed Bun support! See laravel/sail Pull Request #616 for more details.

Paul Redmond photo

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.

Filed in:

Laravel Newsletter

Join 40k+ other developers and never miss out on new tips, tutorials, and more.

Laravel Forge

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Forge
Kirschbaum logo


Providing innovation and stability to ensure your web application succeeds.

Shift logo


Running an old Laravel version? Instant, automated Laravel upgrades and code modernization to keep your applications fresh.

Bacancy logo


Supercharge your project with a seasoned Laravel developer with 4-6 years of experience for just $2500/month. Get 160 hours of dedicated expertise & a risk-free 15-day trial. Schedule a call now!

LoadForge logo


Easy, affordable load testing and stress tests for websites, APIs and databases.

Paragraph logo


Manage your Laravel app as if it was a CMS – edit any text on any page or in any email without touching Blade or language files.

Lucky Media logo

Lucky Media

Bespoke software solutions built for your business. Partner with Lucky Media, your favorite Laravel Development Agency!

Lucky Media
Lunar: Laravel E-Commerce logo

Lunar: Laravel E-Commerce

E-Commerce for Laravel. An open-source package that brings the power of modern headless e-commerce functionality to Laravel.

Lunar: Laravel E-Commerce
Laravel Forge logo

Laravel Forge

Easily create and manage your servers and deploy your Laravel applications in seconds.

Laravel Forge
Oh Dear logo

Oh Dear

Oh Dear is the best all-in-one monitoring tool for all your Laravel apps.

Oh Dear
Tinkerwell logo


The must-have code runner for Laravel developers. Tinker with AI, autocompletion and instant feedback on local and production environments.


The latest

View all →
Get insights into all your Laravel notifications with Paragraphs new package image

Get insights into all your Laravel notifications with Paragraphs new package

Read article
FrankenPHP v1.0 is Here image

FrankenPHP v1.0 is Here

Read article
Self-healing URLs in Laravel image

Self-healing URLs in Laravel

Read article
Laravel 10.35 Released image

Laravel 10.35 Released

Read article
Solve n+1 queries in PHP with Scout APM image

Solve n+1 queries in PHP with Scout APM

Read article
Show Outdated Composer Dependencies in Laravel Pulse image

Show Outdated Composer Dependencies in Laravel Pulse

Read article