2 2. Configuration
René Kreijveld edited this page 2026-05-31 08:43:28 +02:00

Configuration

All ddev-joomla scripts share a single configuration file located at:

~/.config/ddevjoomla/config

Configuration Options

Option Description Default
ROOTFOLDER The directory where your Joomla sites are stored ~/Development/sites
BACKUPFOLDER The directory where backups are saved ~/Development/backup
WEBSERVER Default webserver type for new sites (nginx or apache) nginx
INSTALLER_VERSION Version of the installer that created this file (do not edit) -

Example

ROOTFOLDER=${HOME}/Development/sites
BACKUPFOLDER=${HOME}/Development/backup
WEBSERVER=nginx
INSTALLER_VERSION=1.1

Editing the Configuration

Open the file in any text editor:

nano ~/.config/ddevjoomla/config

Changes take effect immediately - scripts read the config file each time they run.

Notes

  • ROOTFOLDER and BACKUPFOLDER can use ${HOME} or absolute paths.
  • The WEBSERVER setting is used as the default when creating new sites with jaddsite. You can always override it per-site with the -w flag.
  • Scripts will exit with an error if the configuration file is missing. If this happens, re-run the installer to recreate it.