This starter requires sympress/runtime:^1.0 from public Packagist. The committed composer.lock pins stable 1.0.0; use composer install to reproduce it. Runtime needs no private repository or SSH authentication. Any private packages added by your project still need their own Composer authentication. WP-CLI runs from the SHA512-verified root wp-cli.phar because the Composer WP-CLI bundle conflicts with Symfony 8.1 Process.
This guide follows the same idea as Symfony's composer create-project workflow: Composer creates the project directory, then the local runtime installs and boots the application.
Before creating a project, install:
- Docker or a compatible container runtime
- DDEV
- PHP 8.5
- Composer 2
- Git
Host PHP and Composer are used to create the project directory and run the lightweight bin/console setup bootstrap command. The WordPress and SymPress dependencies are installed inside DDEV.
Create a new website project:
composer create-project sympress/starter my_project_directory --no-install
cd my_project_directoryUse a specific development line:
composer create-project sympress/starter:"^1.0" my_project_directory --no-install
cd my_project_directoryUntil sympress/starter is available on Packagist, point Composer at the VCS repository:
composer create-project sympress/starter my_project_directory --no-install \
--repository='{"type":"vcs","url":"https://github.com/sympress/starter"}'
cd my_project_directoryThe --no-install flag is intentional. It prevents Composer from installing dependencies on the host machine so DDEV can run the real install with the expected PHP, database, and webserver environment.
Run the starter setup command from the project root:
bin/console setup my-projectbin/console setup works before vendor/autoload.php exists. It creates .env, sets the DDEV project name, updates WP_HOME and WP_SITEURL, starts DDEV, and runs ddev composer install.
The starter uses DDEV's ddev.site URLs by default, so first setup does not need to edit /etc/hosts.
Manual setup is also possible:
cp .env.example .env
ddev config --project-name=my-project --project-tld=ddev.site --project-type=php --docroot=public --webserver-type=nginx-fpmUpdate the project URL values in .env:
WP_HOME=https://my-project.ddev.site
WP_SITEURL=${WP_HOME}If you used bin/console setup, the project is already installed. Otherwise, start DDEV and install the project manually:
ddev start
ddev composer installComposer triggers SymPress Runtime during install and update. This is intentional: SymPress Runtime creates and syncs the generated WordPress files, writes the local WordPress configuration, and installs WordPress on a fresh database.
Default local admin credentials:
- Username:
admin - Password: generated during
bin/console setupor set throughWP_ADMIN_PASSWORD
You can override them before installation with WP_ADMIN_USERNAME and WP_ADMIN_PASSWORD in .env.
Open the frontend:
ddev launchOpen the WordPress admin:
https://my-project.ddev.site/wp-admin/
For an existing project created from this starter:
git clone git@github.com:your-organization/your-project.git
cd your-project
bin/console setup my-projectAdjust .env if the DDEV project name differs from the default.
Run these smoke checks:
ddev exec wp --info
ddev exec wp core is-installed
ddev exec wp db check
curl -k -I https://my-project.ddev.siteThe HTTP check should return 200 after WordPress has been installed.
You can also run the bundled local check:
bin/console check