Installation

Get Laradebug running on your Mac.

System Requirements

Requirement	Minimum
macOS	11.0 (Big Sur) or later
PHP	8.1 or later
Laravel	9.0 or later
Disk Space	~200 MB

Installation Method

The easiest way to get started — download the pre-built app.

1

Download the DMG

Get the latest version for macOS.

Download for macOS

2

Open the DMG

Double-click the downloaded .dmg file to mount it.

3

Drag to Applications

Drag the Laradebug icon to your Applications folder.

4

First Launch

On first launch, macOS may show a security warning:

1. Right-click (or Control-click) on Laradebug in Applications
2. Select "Open" from the context menu
3. Click "Open" in the dialog that appears

This is only required once.

Build Laradebug from source for development or customization.

1

Clone the Repository

git clone https://github.com/laradebugger/laradebug.git

cd laradebug

2

Install Dependencies

npm install

3

Run or Build

For development with hot reload:

npm run dev

For production build:

npm run build:mac

The built app will be in the dist/ folder.

Build Requirements

• Node.js 18 or later
• npm or yarn
• Xcode Command Line Tools (for macOS builds)

Permissions

Laradebug may request permission to access your file system. This is required to:

• Read your Laravel project files
• Execute PHP/Artisan commands
• Watch for file changes

Verifying Installation

After launching Laradebug:

1. You should see the welcome screen
2. Click Add Project to add your first Laravel project
3. Select a folder containing a valid Laravel installation

Laradebug validates projects by checking for:

• artisan file in the root
• composer.json with Laravel dependency
• Valid PHP installation

Updating

Laradebug will notify you when updates are available. To update:

1. Download the new version
2. Quit the running Laradebug
3. Replace the app in your Applications folder
4. Relaunch

Uninstalling

To remove Laradebug:

1. Quit the application
2. Drag Laradebug from Applications to Trash
3. Optionally, remove settings:

rm -rf ~/Library/Application\ Support/Laradebug
rm -rf ~/Library/Preferences/com.laradebug.app.plist

Next Steps

• Quick Start — Set up your first project
• Configuration — Customize settings