☩ Walking in Light with Christ – Faith, Computing, Diary

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:

1. Update the package database:
    

   # apt update

2. Install the required dependencies:

   # apt install apt-transport-https ca-certificates curl gnupg lsb-release

3. 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

4. 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 
   

    

5. Install Docker Engine:
    

   # apt update sudo apt install docker-ce docker-ce-cli containerd.io

    

6. Start Docker and enable it to run on boot:
    

   # systemctl start docker
# systemctl enable docker

7. Verify Docker installation:
    

   # docker --version

   This 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.
 

1. Pull the Apache HTTP Server image:

   # docker pull httpd

   This 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.

1. Run the Docker container:

   # docker run -d --name apache-container -p 80:80 httpd

   Here’s what the options mean:

   • -d : Runs the container in detached mode (in the background).
   • --name apache-container : Names the container apache-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).

2. Verify the container is running:

   # docker ps

   This will show a list of running containers. You should see the apache-container running.

3. 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 --publish option:

# 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.

1. Create a directory for your custom website:

   # mkdir -p /home/user/my-website

2. Add an index.html file 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

3. Stop the running Apache container:

   # docker stop apache-container

4. Remove the stopped container:

   # docker rm apache-container

5. 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/ httpd

   The -v option mounts the local directory /home/user/my-website to the Apache server’s default document root directory ( /usr/local/apache2/htdocs/ ).

6. 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!

Download PDF

Tags: bash, boot, dependencies, Enjoy, hosting, Install Docker Engine, installed, package database, place, root directory, setup, Stop, sudo

This entry was posted on Friday, February 14th, 2025 at 4:17 pm and is filed under Apache, Debian, Linux, System Optimization. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.