dockershelf/debian repository overview

⁠Quick reference

• Maintained by:
  Luis Alejandro⁠

• Where to get help:
  the Dockershelf Discord⁠, GitHub issues⁠, or Stack Overflow⁠

• Where to file issues:
  https://github.com/Dockershelf/dockershelf/issues⁠

• Supported architectures: amd64, arm64

⁠What is Dockershelf?

Dockershelf is a repository that serves as a collector for docker recipes that are universal, efficient and slim. We keep adding "shelves", which are holders for the different versions of a popular language or application. Images are updated, tested and published weekly via a Github Actions workflow⁠. All images are available on Docker Hub⁠.

Excepting debian and debian images, all images have an stable/unstable version. Stable images are based on debian stable, which are ideal for production applications because packages are not updated to minor or major versions but still recieve security updates. Unstable images are based on debian sid, which are designed for development stages because packages are constantly beaing updated to its latest version. Latex images are only based on debian stable.

Images are built for amd64 and arm64 architectures, which cover most of the devices in the market. If you need an image for a different architecture, please open an issue⁠.

⁠How to use this image

⁠How to use on command line or a Dockerfile

You can pull one of the images from Docker Hub and run it in your machine.

docker pull <image>
docker run -it <image> bash

^{<image> is the desired image to download, for example dockershelf/latex:3.11.}

or you can use it as a base image in your Dockerfile.

FROM dockershelf/debian:bookworm
RUN apt-get update \
    && apt-get install -y mysql-client
ENTRYPOINT ["mysql"]

⁠How to build locally

Clone the Dockershelf repository on your machine.

git clone https://github.com/Dockershelf/dockershelf

Run the build script in the root folder of your local copy. Remember to have docker installed and make sure your user has proper privileges to execute docker build.

bash build-image.sh <image>

^{<image> is the desired image to build, for example dockershelf/node:16-bookworm.}

⁠License

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

Dockershelf source code itself is licensed under the GPLv3 license⁠.