- Create a new repo based on this template
- Run
composer project-setup
- PHP, composer, node, MySQL/MariaDB
- Redis is used for the Craft cache and Sessions
โ if Redis is unavailable, comment out the according config in
config/app.php
andconfig/app.web.php
After launching Craft, a config/license.key
is generated.
Copy the content of the file to the CRAFT_LICENSE_KEY
in .env
and delete config/license.key
.
Finally, uncomment the following line in bootstrap.php
:
define('CRAFT_LICENSE_KEY', getenv('CRAFT_LICENSE_KEY'));
In order to move plugin licences from the project config to the .env
file,
copy the licence to a .env
key and set the key as plugin licence, eg. $PLUGIN_IMAGERX_LICENSE_KEY
.
Search for either swup
or htmx
and hx-
in the code (and in package.json
) and remove the code for the library
you're not using.
Imager X is used to generate image transforms.
IMAGER_TRANSFORMER
may be set to either craft
, imgix
or imageboss
.
If you want to obfuscate the location of your assets (eg. when using imgix or imageboss as web proxy),
set the @imagerBaseUrl
and @imagerBasePath
in config/general.php
and use them in the filesystem settings.
After the first deployment, run:
composer install
composer storage:link
php craft setup
Fix issues with applying the craft config during deployment:
php craft project-config/rebuild
git reset --hard
php craft project-config/apply