Quick Start
Quick Start
Get your local WordPress development environment up and running in less than five minutes using Docker.
Prerequisites
Ensure you have the following installed on your machine:
- Git
- Docker Desktop (which includes Docker Compose)
1. Clone the Repository
Clone the project to your local machine and navigate into the directory:
git clone https://github.com/UditAkhourii/wordpress.git
cd wordpress
2. Configure Environment Variables
The project uses a .env file to manage database credentials and site configurations. Create your local version from the template:
cp .env.example .env
Note: For local development, the default values in .env.example are usually sufficient. If port 8080 is already in use on your machine, update the PORT variable in your new .env file.
3. Launch the Environment
Start the WordPress and MySQL containers in the background:
docker-compose up -d
Docker will pull the necessary images, set up the network, and mount your local files into the container.
4. Access the Site
Once the containers are healthy, you can access your local WordPress installation via your browser:
| Interface | URL | | :--- | :--- | | Public Site | http://localhost:8080 | | WP Admin | http://localhost:8080/wp-admin |
5. Common Commands
| Action | Command |
| :--- | :--- |
| Stop Environment | docker-compose down |
| View Logs | docker-compose logs -f |
| Restart Services | docker-compose restart |
Internal Note: The core WordPress configuration is handled via the docker-compose.yml file. While these settings are internal to the infrastructure setup, you may modify the volume mappings there if you wish to change the local directory used for theme or plugin development.