Deploying a Docker container with Apache on Debian Linux is an efficient way to manage web servers in isolated environments. Docker provides a convenient way to package and run applications, and when combined with Apache, it can be used for hosting websites or web applications. In this guide, we’ll walk through the necessary steps to set up and run an Apache web server inside a Docker container on a Debian Linux machine.
Prerequisites
Before starting, ensure that you have the following prerequisites in place:
- A Debian-based Linux system (e.g., Debian 10, Debian 11).
- Docker installed on your system. If you don’t have Docker installed, follow the installation steps below.
- Basic knowledge of Linux commands and Docker concepts.
Step 1: Install Docker on Debian
First, you need to install Docker if it is not already installed on your Debian machine. Here’s how to install Docker on Debian:
-
Update the package database:
# apt update -
Install the required dependencies:
# apt install apt-transport-https ca-certificates curl gnupg lsb-release -
Add Docker’s official GPG key:
# curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg -
Set up the stable Docker repository:
#
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \ https://download.docker.com/linux/debian $(lsb_release -cs) stable" \ | tee /etc/apt/sources.list.d/docker.list > /dev/null -
Install Docker Engine:
# apt update sudo apt install docker-ce docker-ce-cli containerd.io -
Start Docker and enable it to run on boot:
# systemctl start docker
# systemctl enable docker -
Verify Docker installation:
# docker --versionThis should display the installed Docker version, confirming that Docker is installed successfully.
Step 2: Pull Apache Docker Image or whatever docker image you want to have installed
Now that Docker is set up, you need to pull the official Apache image from Docker Hub. The Apache image is maintained by the Docker team and comes pre-configured for running Apache in a container.
-
Pull the Apache HTTP Server image:
# docker pull httpdThis will download the official Apache HTTP server image (
httpd) from Docker Hub.
Step 3: Run Apache Container
Once the Apache image is pulled, you can start a Docker container running Apache.
-
Run the Docker container:
# docker run -d --name apache-container -p 80:80 httpdHere’s what the options mean:
-
-d: Runs the container in detached mode (in the background). -
--name apache-container: Names the containerapache-container. -
-p 80:80: Maps port 80 on the host to port 80 in the container (so you can access the Apache web server through port 80). -
httpd: The name of the image you want to run (the Apache HTTP server).
-
-
Verify the container is running:
#
docker psThis will show a list of running containers. You should see the
apache-containerrunning. -
Test the Apache server:
Open a web browser and go to
http://<your-server-ip>. You should see the default Apache welcome page, indicating that Apache is running successfully in the Docker container.
Step 4: Customize Apache Configuration (Optional)
You may want to customize the Apache configuration or serve your own website inside the container. Here’s how to do it:
. Run the Apache Docker Container with a Specific IP Address
To bind the container to a specific IP address, use the
--add-host
or
--publish
flag while running the container.
- If you want to bind Apache to a specific IP address on the host (for example,
192.168.1.100), use the--publishoption:
# docker run -d --name apache-container -p 192.168.1.100:80:80 apache-container
This command tells Docker to bind port 80 in the container to port 80 on the host's IP address
192.168.1.100
. Replace
192.168.1.100
with the desired IP address of your system.
-
Create a directory for your custom website:
# mkdir -p /home/user/my-website -
Add an
index.htmlfile or whatever PHP / Perl whatever files will be served:Create a simple HTML file in the directory:
# echo '<html><body><h1>Hello, Apache on Docker!</h1></body></html>' > /home/user/my-website/index.html -
Stop the running Apache container:
# docker stop apache-container -
Remove the stopped container:
# docker rm apache-container -
Run a new container with your custom website:
Now, you can mount your custom directory into the container as a volume:
# docker run -d --name apache-container -p 80:80 -v /home/user/my-website:/usr/local/apache2/htdocs/ httpdThe
-voption mounts the local directory/home/user/my-websiteto the Apache server’s default document root directory (/usr/local/apache2/htdocs/). -
Verify the custom website:
Reload the web page in your browser. Now, you should see the "Hello, Apache on Docker!" message, confirming that your custom website is being served from the Docker container.
Step 5: Manage Docker Containers
You can manage the running Apache container with the following commands:
-
Stop the container:
# docker stop apache-container -
Start the container:
# docker start apache-container -
Remove the container (if needed):
# docker rm apache-container -
View logs for troubleshooting:
# docker logs apache-container
Step 6: Automating Docker Container Deployment (Optional step)
If you want the Apache container to restart automatically after a system reboot, you can add the
--restart
flag to the
docker run
command.
For example, to make the container restart automatically unless it is manually stopped, use:
# docker run -d --name apache-container -p 80:80 --restart unless-stopped \ -v /home/user/my-website:/usr/local/apache2/htdocs/ httpd
Conclusion
By following these steps, you can easily deploy Apache inside a Docker container on a Debian Linux machine. Docker allows you to run your Apache web server or whatever docker app you need to have in a lightweight and isolated environment, which is useful development, testing, and production environments. You can further customize this setup by adding additional configurations, integrating with databases, or automating deployments with Docker Compose or Kubernetes.
Enjoy your new Dockerized Apache setup!
