DEV Community

Cover image for How I Deployed my Website as a Docker Container
Paschal Ogu
Paschal Ogu

Posted on • Originally published at

How I Deployed my Website as a Docker Container

One of the greatest nightmares of developers is the “It's not working on my machine” problem. I struggled to run my website locally on different machines too. Shout out to Brittany Mitchell for giving me the idea to containerize my website. Containerization allowed me to build my website and run it consistently across different environments and machines. Docker is the tool for achieving this containerization.

Image Source: r/ProgrammerHumour

What is Docker?

Docker is an open-source platform for developing, shipping, and running applications. It is a technology that allows you to incorporate and store your code and its dependencies into a neat little package called an image.

Dockerfile, Docker Image, and Docker Container


A Dockerfile is a text file containing a collection of commands or procedures. Consider this file as a script that defines how our container image will be built.

Docker Image:

A docker image is a packaged, runnable instance of an application or environment. It contains everything needed to run a piece of software (or website in our case), including the code, a runtime, libraries, environment variables, and configuration files. A docker image is read-only template for creating containers.

Docker Container:

A docker container is a lightweight, stand-alone, executable package of software that includes everything needed to run the software. Containers isolate applications from each other and the underlying infrastructure while providing an added layer of protection for the application. Containerization solves the problem related to application deployment, and scalability. It helps promote consistency and efficiency in software development and operations.

Image Source: JFROG

Here is how I containerized my website

As a prerequisite, ensure that you have docker installed locally on your machine. Install Docker Engine

The code for my website is hosted on GitHub. To follow along, fork and clone this repository and change directory into it by running the commands below:

git clone
cd personal-website
Enter fullscreen mode Exit fullscreen mode

Step 1: Build the Docker image

  • Add a Dockerfile

I created a new file named Dockerfile by running the command touch Dockerfile in the root of my website directory and added these lines of code below inside the Dockerfile:

FROM nginx:alpine

COPY . /usr/share/nginx/html

Enter fullscreen mode Exit fullscreen mode

The FROM nginx:alpine line tells Docker to create a Docker image based on the Nginx web server with Alpine Linux. The COPY . /usr/share/nginx/html line will copy the website content from the directory we are in into the image being built. This means that our website code will replace the default Nginx web server content. EXPOSE 80 specifies that the container should be capable of serving HTTP traffic on port 80.

  • Build Image

Then I built the image by running the line of code below:

docker build -t personal-website:v1 .
Enter fullscreen mode Exit fullscreen mode

docker build command tells docker to build our website as an image based on the instructions provided in a Dockerfile above. The -t personal-website:v1 tells docker to tag the image personal-website:v1. v1 signifies that this is version 1. The period (.) tells Docker to look for the Dockerfile in the current directory and use the files and directories in this location during the build process.

Docker build

Running the command docker images shows this image I just built:

Image description

Step 2: Push to Docker Registry

I logged in to Docker Hub Container Image Library and created a new repository. I named it personal-website and gave it a short description (description is optional).

Docker Registry

Then I ran the docker push command below to push the image I built in the previous step, but it failed with the error below 😞.

docker push paschalogu/personal-website:v1

The push refers to repository [[](]
An image does not exist locally with the tag: paschalogu/personal-website
Enter fullscreen mode Exit fullscreen mode

Why did it fail? The push command was looking for an image named paschalogu/personal-website:v1, but didn't find one.

To fix this, I ran the docker tag command to tag my image and then re-ran the docker push command to push to my docker repository.

docker tag personal-website:v1 paschalogu/personal-website:v1

docker push paschalogu/personal-website:v1
Enter fullscreen mode Exit fullscreen mode

Step 3: Test Configuration

Opened my browser and navigated to the website

Selected Login and then chose docker from the drop-down list. Then, I sign in with my Docker Hub account and clicked the Start button.

I clicked on ADD NEW INSTANCE option on the left sidebar. After a few seconds, a terminal window opened up in my browser.

In the terminal, I started my freshly pushed wevsite.

docker pull paschalogu/personal-website:v1

docker run -dp 80:80 paschalogu/personal-website:v1
Enter fullscreen mode Exit fullscreen mode

Will you be running your applications and websites as a docker container? Let me know in the comments. Feel free to connect with me on LinkedIn at and on Twitter @Paschal_Ik


Top comments (5)

ingosteinke profile image
Ingo Steinke • Edited

Sounds like you've learned a lot about Docker, which is a good thing, but it seems too much overhead to me to deploy a dedicated Alpine operating system image only to serve a website that looks, at least at first sight, fit to run on any shared or dedicated host and webserver (nginx like in your container, but also Apache or even IIS).

Docker might solve the backend part of "runs on my computer" but not the frontend aspect, as there are still different client browsers that can access your website so you should test the frontend on Chrome, Safari, Firefox including different mobile phones, no matter which backend will serve the code.

necrophcodr profile image

Fortunately it is very little overhead, but running it on a static hosted service might be more ideal depending on what the goal and philosophy is.

briandesousa1 profile image
Brian De Sousa

Great work @paschalogu! You stated the problem you are going to solve up front and clearly walked through how you addressed it. This is a good summary/intro for folks who have not worked with Docker before and may be looking for somewhere to start. Thanks!

soynegro profile image
Christopher Valdes De La Torre

This is an accessible and replicable introduction to Docker, which is suitable for the starting folks. And in the same line, you could add a follow-up running the image from platforms like Render or Railway.

nathan_tarbert profile image
Nathan Tarbert

Nice article, I'm currently wanting to containerize my project and don't know all the in's and out's of Docker so thanks for the run through.