Tiny Python Docker image

The most lightweight Python 3 Docker image possible.

.. image:: https://github.com/CrafterKolyan/tiny-python-docker-image/actions/workflows/update-readme-table.yml/badge.svg?branch=main :target: https://github.com/CrafterKolyan/tiny-python-docker-image/actions/workflows/update-readme-table.yml

Possible variants

.. csv-table:: :header: Dockerfile,Description,Size,Version :widths: 10, 70, 10, 10

Dockerfile.scratch-minimal,Minimal Python image with almost no libraries from scratch,6.014 MB,3.11.8
Dockerfile.scratch-full,Smallest Python image with default libraries from scratch,24.22 MB,3.11.8
Dockerfile.haizaar-minimal,Stripped official Python image (`haizaar/python-minimal`_),38.44 MB,3.12.2
Dockerfile.alpine,Alpine-based,49.65 MB,3.11.8
Dockerfile.python-alpine,Python Alpine-based Official,51.76 MB,3.12.2
Dockerfile.ubuntu,Ubuntu-based,107.4 MB,3.10.12
Dockerfile.python-slim,Minimal packages needed to run python,129.8 MB,3.12.2
Dockerfile.python,Python Debian-based Official with a lot of packages,1018 MB,3.12.2

Requirements

• Docker

Usage

Building image

.. code-block:: bash

    docker build -t python-tiny . -f <Dockerfile name>

For example:

.. code-block:: bash

    docker build -t python-tiny . -f Dockerfile.scratch-full

Running image
`````````````
.. code-block:: bash

  docker run --rm -it python-tiny

Technologies
------------
- Docker
- :code:`ldd` (prints the shared libraries required by each program or shared library specified on the command line): used to create :code:`scratch-full` and :code:`scratch-minimal` images.

Related links
-------------
- https://xebia.com/blog/how-to-create-the-smallest-possible-docker-container-of-any-image/
- https://xebia.com/blog/create-the-smallest-possible-docker-container/

Related projects
----------------
- https://github.com/jfloff/alpine-python
- https://github.com/haizaar/docker-python-minimal

.. _haizaar/python-minimal: https://github.com/haizaar/docker-python-minimal