ContextQMD
Back to Devbox

LEPP Stack

examples/stacks/lepp-stack/README.md

0.17.21.5 KB
Original Source

LEPP Stack

An example Devbox shell for NGINX, Postgres, and PHP. This example uses Devbox Plugins for all 3 packages to simplify configuration

How to Run

Initializing

In this directory, run: devbox run init_db to initialize a db.

To start the Servers + Postgres service, run: devbox services start

Creating the DB

You can run the creation script using devbox run create_db. This will create a Postgres DB based on setup_postgres_db.sql.

Testing the Example

You can query Nginx on port 80, which will route to the PHP example.

How to Recreate this Example

  1. Create a new project with:

    bash
    devbox create --template lapp-stack
devbox install

  2. Update devbox.d/nginx/httpd.conf to point to the directory with your PHP files. You'll need to update the root directive to point to your project folder

  3. Follow the instructions above in the How to Run section to initialize your project.

Note that the .sock filepath can only be maximum 100 characters long. You can point to a different path by setting the PGHOST env variable in your devbox.json as follows:

"env": {
    "PGHOST": "/<some-shorter-path>"
}