Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mdshahbazsid/docker-webserver
Docker WebServer - Apache, MySQL, and PHP
https://github.com/mdshahbazsid/docker-webserver
apache composer docker elasticsearch magento2 mailhog mysql ngrok php phpmyadmin ssl varnish
Last synced: 2 days ago
JSON representation
Docker WebServer - Apache, MySQL, and PHP
- Host: GitHub
- URL: https://github.com/mdshahbazsid/docker-webserver
- Owner: mdshahbazsid
- Created: 2025-01-06T12:17:58.000Z (18 days ago)
- Default Branch: main
- Last Pushed: 2025-01-21T07:58:01.000Z (3 days ago)
- Last Synced: 2025-01-21T08:25:25.769Z (3 days ago)
- Topics: apache, composer, docker, elasticsearch, magento2, mailhog, mysql, ngrok, php, phpmyadmin, ssl, varnish
- Language: PHP
- Homepage:
- Size: 6.42 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker-WebServer
Docker WebServer - Apache, MySQL, and PHP
**Specifically engineered to seamlessly run Magento, the Adobe Commerce platform.
## Supported PHP Versions :
- Php 8.3
- Php 8.2
- Php 8.1
- Php 7.4
## Installed Services :
```php
- webserver (apache with php) | Port - 80:80 For HTTP, Port - 443 For HTTPS
- composer | N/A
- mariadb | Port - 3306:3306
- phpmyadmin | Post - 8081:80
- varnish | Port - 8082:80
- elasticsearch | Port - 9200:9200
- mailhog | Port - 8025 For UI, Port - 1025 For SMTP Server
- ngrok | Port - 4040
```
- __Webserver (Apache with PHP)__
- __Description:__ Apache HTTP Server with PHP integration to serve dynamic web pages.
- __Ports:__ 80:80
- __Usage:__ It is used to host and serve web applications.
- __Composer__
- __Description:__ Dependency manager for PHP, used for managing libraries and packages in PHP projects.
- __Ports:__ N/A
- __Usage:__ It is used to install and update dependencies in PHP projects.
- __MariaDB__
- __Description:__ An open-source relational database management system, a fork of MySQL.
- __Ports:__ 3306:3306
- __Usage:__ It is used to manage databases for web applications.
- __PhpMyAdmin__
- __Description:__ A free and open-source administration tool for MySQL and MariaDB.
- __Ports:__ 8081:80
- __Usage:__ It provides a web interface to manage MySQL and MariaDB databases.
- __Varnish__
- __Description:__ A caching HTTP reverse proxy that can accelerate web applications by caching content.
- __Ports:__ 8082:80
- __Usage:__ It is used to improve the performance of web applications by caching static content.
- __Elasticsearch__
- __Description:__ A distributed, RESTful search and analytics engine capable of solving a growing number of use cases.
- __Ports:__ 9200:9200
- __Usage:__ It is used to index and search data for web applications.
- __MailHog__
- __Description:__ An email testing tool for developers that captures outgoing emails and provides a web interface to view them.
- __Ports:__ 8025 (UI), 1025 (SMTP Server)
- __Usage:__ It is used to test email sending functionality in web applications without sending emails to the actual recipients.
- __Ngrok__
- __Description:__ Ngrok is a service that creates secure tunnels from the internet to your local machine. It is often used to expose local development servers to the web, which can be helpful for testing webhooks, sharing a local website, or remote debugging.
- __Ports:__ 4040
- __Usage:__ It creates a public URL (like https://your-subdomain.ngrok.io) that forwards traffic to your local server.
## Prerequisites
##### 1. Install Docker and Docker Compose
Docker must be installed on your system, along with Docker Compose. Follow the instructions in the official or community-provided documentation:
- [How to Install and Use Docker on Ubuntu (DigitalOcean)](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-20-04)
- [How to Install and Use Docker Compose on Ubuntu (DigitalOcean)](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-ubuntu-20-04)
##### 2. Set Proper Permissions for the `.docker` Directory
The `.docker` folder must have the appropriate permissions to ensure smooth operation. Use the following command to grant necessary permissions:
```bash
sudo chmod -R 755 .docker/
```
## Setup Instructions
##### 1. Configuration Files
- **`.env` File**: Used to declare global variables such as database username, password, and database name.
- **`custom-php.ini` File**: Used to define custom `php.ini` variables.
##### 2. Folder Structure
- **Root Path**: All source files should be placed in the `src/` directory.
- **Docker Directory**: Create a directory to store your Docker setup, e.g., `docker-local`, and extract all the Docker-related files into this directory.
##### 3. Docker Commands
- Create a folder anywhere like `docker-local` in your system and extract all the Files In the Above Folder.
- Add the following entry to your /etc/hosts file and save it:
```bash
127.0.0.1 localhost local.docker.com
```
- Go to the above directory an Run Command :
```bash
bash docker-init
```
- Build the Docker images:
```bash
bash docker-build
```
- Start the Docker images:
```bash
bash docker-start
```
- Verify that the containers are running:
```bash
bash docker-ps
```
- Restart the Docker containers:
```bash
bash docker-restart
```
- Stop the Docker containers:
```bash
bash docker-stop
```
- Accessing the Docker Container, To access the webserver container's shell as the `jarvis` user:
```bash
bash docker-inside
```
- Access **Apache WebServer :** http://localhost/
- Access **phpMyAdmin :** http://localhost:8081/
- Access **MailHog :** http://localhost:8025/
- Access **ElasticSearch :** http://localhost:9200/
- Access **Ngrok :** http://localhost:4040/
## Setup Magento 2
- **Install Magento 2.x :** All the commands below must be executed inside the Docker container.
- **Create Empty Directory :** To install Magento Create the Empty directory By Command:
```bash
mkdir magento
cd magento
```
- **Create Empty Database :** Create empty database by running below command:
```bash
(This command must be run outside the Docker container) :
-----------------------------------------------------------------------------
docker exec -it -uroot -ppassword -e 'CREATE DATABASE magento;'
```
- **Community Edition (CE) :** To install the Community Edition (CE), use the following command:
```bash
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.*
```
- **Enterprise Edition (EE) :** To install the Enterprise Edition (EE), use the following command:
```bash
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.*
```
- **Magento Installation Command**
```bash
php bin/magento setup:install \
--base-url=http://local.docker.com/magento/pub/ \
--db-host=mysql-db \
--db-name=magento \
--db-user=root \
--db-password=password \
--admin-firstname=Admin \
--admin-lastname=Admin \
[email protected] \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--backend-frontname="admin" \
--use-rewrites=1 \
--search-engine=elasticsearch7 \
--elasticsearch-host=elasticsearch \
--elasticsearch-port=9200
```
- **Disable Two-Factor Authentication Modules :** To disable the two-factor authentication modules, use the following command:
```bash
php bin/magento module:disable Magento_AdminAdobeImsTwoFactorAuth Magento_TwoFactorAuth
```
- **Install Magento Sample Data :** To deploy Magento sample data, use the following command:
```bash
php bin/magento sampledata:deploy
```
- **Run Magento Commands Using a Script :** To simplify running Magento commands, you can use the deploy_magento.sh script. Make sure the script is located in the Magento root directory.
```bash
bash deploy_magento.sh
```
**Note :** Ensure the file deploy_magento.sh exists in the / directory.
## Help and Support
- Custom Php ini file support : .docker/custom-php.ini
- File deploy_magento.sh Location : src/misc/deploy_magento.sh
- Magento Command Help : src/misc/Help_Mage.txt
- Known Docker Issues Refer to File : Issues.txt
- Apache Default Site : .apache/000-default.conf
- SSL Certificates : .ssl/
- Crontab : .apache/crontab
## Maintainer
- Dev. Mohd Shahbaz | @[email protected]