v. 1.21.0


To run apps based on the Laravel framework using Unit:

  1. Install Unit with a PHP language module.

  2. Install and configure Laravel’s prerequisites.

  3. Install Laravel’s core files.

  4. Create a Laravel project. For our purposes, the path is /path/to/app/:

    $ cd /path/to/app/
    $ laravel new blog
  5. Set installation path permissions to secure access, for example:

    # chown -R app_user:app_group /path/to/app/

    Update the placeholders above with actual values, noting them for later use in Unit configuration.


    See the Laravel docs for further details on server configuration and directory structure.

  6. Next, put together the Laravel configuration for Unit:

        "listeners": {
            "*:80": {
                "pass": "routes/laravel"
        "routes": {
            "laravel": [
                    "match": {
                        "uri": "!/index.php"
                    "action": {
                        "share": "/path/to/app/blog/public/",
                        "fallback": {
                            "pass": "applications/laravel"
        "applications": {
            "laravel": {
                "type": "php",
                "user": "app_user",
                "group": "app_group",
                "root": "/path/to/app/blog/public/",
                "script": "index.php"
  7. Upload the updated configuration. Assuming the JSON above was added to config.json:

    # curl -X PUT --data-binary @config.json --unix-socket \
           /path/to/control.unit.sock http://localhost/config/


    The control socket path may vary; run unitd --help or see Startup for details.

  8. After a successful update, browse to http://localhost and set up your Laravel application:

Laravel on Unit - Sample Screen