Skip to content

Installation

  • DDEV
  • A code editor. This project has configuration files for VSCode.
  • GitFlow (optional)

Project names should contain no hyphens, capitals or punctuation marks.

This includes

  • GitHub repository name
  • DDEV .config file values
  1. Create a new GitHub repository with this repository as template.

  2. Clone the newly created repository to your computer.

  3. Change the name in .ddev/config.yaml to correct project name (usually the repository name)

    .ddev/config.yaml
    name: lumbermill
    name: yourprojectname
  4. Create auth.json in the project root and paste the following content, this file is used for installing Advanced Custom Fields

    auth.json
    {
    "http-basic": {
    "connect.advancedcustomfields.com": {
    "username": "b3JkZXJfaWQ9Njc3OTl8dHlwZT1kZXZlbG9wZXJ8ZGF0ZT0yMDE1LTEwLTMxIDEzOjE3OjA4",
    "password": "https://localhost"
    }
    }
    }

    There is no need to change the values

  5. Start DDEV

    Terminal window
    ddev start
  6. Build theme assets

    Terminal window
    ddev npm run build
  7. Run the WordPress installation by opening the project in your browser.

    Terminal window
    ddev launch
  8. Installation Values

    Replace Project Name/project-name with the project name

  9. Store the login details somewhere safe.

    Bitwarden is a solid choice. Share passwords securely via secrets.instance.studio.

  10. Login to the wp-admin area.

  11. Update the Permalink settings found under Settings in the menu to Post name

My pages are 404’ing

Add the following .htaccess file to the web folder

web/.htaccess
<IfModule mod_rewrite.c>
# BEGIN WordPress
RewriteEngine On
RewriteRule .\* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
</IfModule>