Public | Automated Build

Last pushed: 2 months ago
Short Description
run flask application in an alpine os docker image
Full Description

Alpine OS running Python Flask (with Python 2.7 or 3.5)


  • latest - flask running on python 2.7
  • python3 - flask running on python 3.6

This image is used to run flask applications. To start a container use

docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -d jazzdd/alpine-flask

-v /path/to/app/:/app - specifies the path to the folder containing a file named, which should be your main application

-p 80:80 - the image exposes port 80, in this example it is mapped to port 80 on the host

Installing additional python or flask packages

This image comes with a basic set of python packages and the basic flask and python-pip installation.

If you need any non-default python or flask packages, the container will install them on its first run using python pip and a requirements.txt file. Save a requirements.txt file in the root folder of your app, which is mounted to the /app folder of the container. The format of the file is described in the pip documentation. After that you can create a new container with the above docker command. The entrypoint script will take care of the package installation listed in the requirements file.

If an additional package is needed during runtime of the container it can be installed with following command.

docker exec YOUR_CONTAINER_ID/NAME /bin/bash -c "pip install package-name"

Installing additional Alpine packages

Sometimes, additional python or flask packages need to build some dependecies. Additional Alpine packages can be installed into the container using a requirements file similar to the python requirements file. Listed packages will be installed on the first run of the container.

You need to save a file named requirements_image.txt into the root folder of your app, which is mounted to the /app folder of the container. Just write the packages separated with space or a new line into the file.


The flask application is started using a UWSGI socket.

Nginx is used to map the socket to port 80 within the image. This image does not offer any SSL capability, please use a nginx proxy for this. Nginx will deliver static content (e.g. CSS or JS Files) directly without going through flask or uwsgi.

Log messages

Logs can be displayed using docker logs -f CONTAINER_ID/NAME

Using this image to control docker with flask

This image can be used to create a privileged container, which can control your docker server. Therfore the docker socket must be mounted as volume within this container and an additional option is needed to run the container.

docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -d jazzdd/alpine-flask -o gid

-o gid enables the docker option (docker will be installed into the container on the first run). GID is the docker group id of your host system. The container matches the gid of the docker group and adds the nginx user (this user is running nginx and uwsgi) to the docker group.

Now you could use:

from subprocess import call
call(["docker", "run", "-p 80" ,"-v /path/to/app/:/app", "-d jazzdd/alpine-flask"])

to get another container running with the flask app.

Debug mode

Debug mode means the container doesn't use uwsgi and nginx but starts the flask app with a simple python So you can make use of the build-in flask development webserver and the automated reload system after editing the application.

To start a container in debug mode use:

docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -d jazzdd/alpine-flask -d

Your file must have a section similiar to the following example to start the app within the debug mode.

if __name__ == '__main__':'', port=80, debug=True)

To get the command line output of your app use docker logs -f CONTAINER_ID/NAME.

Docker Pull Command
Source Repository