Herd Manager

Web-based management tool for exposing Laravel Herd sites to your local network.

Features

• Expose local sites to your network with custom ports
• Create and manage reverse proxies for development servers
• Intuitive web interface
• RESTful API
• Port availability checking
• Automatic update notifications (checks for new commits in the remote repository)

Requirements

• PHP 8.4+
• Laravel Herd
• Composer
• macOS

Installation

1. Navigate to the Herd directory:

cd ~/Herd

2. Clone and install:

git clone https://github.com/danie1net0/laravel-herd-manager.git herd-manager
cd herd-manager
composer install

3. Access via http://herd-manager.test

Usage

Web Interface

Access http://herd-manager.test to manage your sites through the web interface.

API

List sites:

curl http://herd-manager.test/api/sites

Get local IP:

curl http://herd-manager.test/api/sites/ip

Check port:

curl http://herd-manager.test/api/sites/check-port?port=8000

Apply configurations:

curl -X POST http://herd-manager.test/api/sites/apply \
  -H "Content-Type: application/json" \
  -d '{"sites": [{"name": "my-site", "url": "http://my-site.test", "port": 8000}]}'

List proxies:

curl http://herd-manager.test/api/proxies

Create proxy:

curl -X POST http://herd-manager.test/api/proxies \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app", "port": 3000}'

Delete proxy:

curl -X DELETE http://herd-manager.test/api/proxies/my-app

Check for updates:

curl http://herd-manager.test/api/updates/check

Testing

# Run all tests
composer test

# With coverage
composer test:coverage