Joomla User Manual

Laptop Hosting

Background

It is not practicable to host a website on a laptop! However, many site developers use a laptop or desktop for testing and experimentation. It can be free and not difficult for anyone willing to learn. This article sets out the basic steps. But beware, you may come across many other articles on this topic, some of which describe out-of-date technologies!

At the end, you will be able to create as many web sites as you need for testing and development purposes. When satisfied, you can deploy a development site to a public web server. That part is not covered here.

The article content is based on the steps required for installation on a Macbook Pro. It should be very similar on a Windows or Linux computer.

Acknowledgement

This article is based on presentations given by René Kreijveld at the 2026 Joomla World Conference and at the Joomla User Group London (November 2026). Some references:

  • DDEV: Docker-based PHP and Node.js development environments
  • ddev-joomla: Bash scripts to support Joomla in DDEV
  • DDevUI: A cross-platform polished desktop app for managing DDEV local development environments — everything the ddev CLI does, behind a beautifully designed UI.
  • JWC26 Slides: Joomla development with DDEV

What is DDEV and how to install it

DDEV is a Docker based, PHP and Node.js development platform providing isolated per project environments such as PHP and database versions.

  • DDEV is free ...
  • Instructions are available online.

DDEV Site

Do not worry if you already have a web server, databases and PHP installed. DDEV will not be interfere with them.

1. Install Orbstack Docker Provider with Homebrew

Orbstack is a Mac only application that is not free for prefessional use. Other platforms have other choices.

brew install orbstack docker

This is what it looks like as an App:

Orbstack screenshot

2. Confirm docker is installed

docker version

*Response:*
Client: Docker Engine - Community
    Version:           29.10.0
    ...
Server: Docker Engine - Community
    Engine:
    Version:          29.8.2
...

3. Install DDEV

brew install ddev/ddev/ddev
...

4. Create a local CA

mkcert -install
    ... problem, so
brew install nss (and do mkcert -install again)

5. Make a directory for all projects

cd ~
mkdir ddev

6. Make a directory for first project

mkdir ddev/jdev1

7. Change to the project directory

cd ddev/jdev1

8. Configure the project

ddev config
    ...
    Use project root as site root and joomla as a project type

9. Start the project

ddev start

10. Launch the project

This activates the preferred browser and opens a tab to the configured site.

ddev launch (this will throw a 403 error because Joomla has not been installed)

11. Fetch Joomla

There are two ways to do this:

  • Fetch the latest version of Joomla for a normal user installation
curl -sL https://www.joomla.org/latest > joomla.zip
unzip -q -o joomla.zip && rm $_
ddev config
ddev launch
  • Clone the Joomla repository for a version suitable for testing where Javascript and CSS changes are needed. But first install git.
cd ..
git clone https://github.com/joomla/joomla-cms.git
mv joomla-cms jdev2
cd jdev2
... Follow the instructions in the joomla-cms repository README

ddev config
ddev launch

12. Install Joomla

This is the normal installation sequence except that all four of the database credentials are db.

You now have a fully functional Joomla site!

ddev-joomla

This is a set of cross-platform scripts available in every DDEV Joomla project. It wraps repetitive tasks into single commands. Examples include new site creation, switch of PHP version, backups and so on. It is open source and self-updating.

Installation

sudo /bin/zsh -c "$(curl -fsSL https://code.kreijveld.com/renekreijveld/ddev-joomla/raw/branch/main/installer/ddev-joomla-installer.sh)"

Change ownership of .config/ddevjoomla/config to match the user.

See the Installation Instructions for further details. This is an example of a one-line command to install a new site:

jaddsite -n joomlademo -p 8.5 -j -a
... 
    Where 
    -n = sitename
    -p = php version
    -j = download and install joomla
    -a = add Adminer (db management tool)

The full list of tools:

jddev 3.6, written by René Kreijveld.
Overview of all available ddev-joomla scripts.

jaddsite -- Add a new Joomla site to DDEV.
jdelsite -- Permanently delete a DDEV Joomla website and its files.
jclone -- Clone an existing DDEV Joomla project to a new project name.
jphpswitch -- Switch the PHP version of an existing DDEV Joomla project.
jlatest -- Download and extract a Joomla release into the current folder.
jdbdump -- Export the DDEV database to a SQL dump file.
jdbdumpall -- Export the DDEV database of all Joomla projects to SQL dump files.
jdbdumptable -- Export one table from the DDEV database to a SQL dump file.
jdbimp -- Import a SQL dump file into the DDEV database.
jbackup -- Full backup of a Joomla site (database dump + archive).
jbackupall -- Full backup of all DDEV Joomla projects (database dump + archive).
jxdb -- Displays xdebug status and enables or disables xdebug.
jddev-vsc-xdb -- Show the default VSCode launch.json for debugging with Xdebug.
joomlainfo -- Displays info about the Joomla project and shows DDEV description.
jsetconfig -- Set the essential DDEV values in the configuration.php of the current Joomla site.
jlistjoomlas -- List all Joomla sites found under the configured root folder.
gosite -- Navigate to the document root of a Joomla site.
setrights -- Set correct file (644) and folder (755) permissions recursively.
jddev-update -- Update all ddev-joomla scripts from the ddev-joomla repository main branch.
jddev-status -- Show the ddev-joomla configuration and the state of the installation.

An example, change php version then check with joomlainfo:

screenshot of joomlainfo data

DDevUI

This is an optional graphical interface for managing DDEV local development environments — everything the ddev CLI does, behind a beautifully designed UI.

DDevUI Installation

brew install --cask shiv122/tap/ddevui

Then start it from the list of available apps.

ddevui screenshot

Debugging with Xdebug

Debugging involves setting a breakpoint in the code with your favourite IDE and then running the code up to that point by loading a web page. Caommands to obtain status and enable or disable xdebug:

jxdb
    response: xdebug disabled
jxdb on
    response: Enabled xdebug
jxdb off
    reponse: Disabled xdebug

In the project root create a .vscode folder and a launch.json file. Create the contents with jddev-vsc-xdb and paste the result into the launch.json file. Set a breakpoint in VSCode, remember to set jxdb on and reload the appropriate page. Execution should stop at the breakpoint.

Add-ons

DDEV has lots of additional tools. There is a good chance you will need a database management tool such as phpMyAdmin or Adminer. For a complete list of tools:

ddev add-on list | more
    response: paged table of add-ons
ddev add-on list | grep phpMyAdmin
    response: │ ddev/ddev-phpmyadmin │ Web-based phpMyAdmin interface for MySQL, │

# in the root of a site:
ddev add-on get ddev/ddev-phpmyadmin
    response: 
    ...
    You can now use 'ddev phpmyadmin' to launch PhpMyAdmin
    ...
ddev phpmyadmin
    response: a few seconds and phpMyAdmin appears in a new browser tab

Testing Email

Mailpit is installed in DDEV by default. To start it:

ddev mailpit
    response: a browser tab opens with the Mailpit GUI.

Go to the Global Configuration page in your Joomla site and send a test message with the default settings. Then go to the Mailpit tab and see that the test message has arrived.