Dockerfiles for the base images used in Bitnami Stacksmith


Stacksmith Base Docker image


FROM bitnami/minideb-extras:jessie


The Stacksmith Base Docker image is a customized base image for use in Bitnami container images and is built on top of the light-weight and Debian-based bitnami/minideb image. Learn more about bitnami/minideb in Minideb: A New Container Base Image.

The Dockerfile installs Nami and includes a bitnami-pkg helper script to simplify downloading of Nami modules from the Bitnami package repositories. Additionally the Dockerfile installs tini and is used in the default entrypoint.


The image is available in two variants:

Image Configuration
bitnami/minideb-extras:jessie Standard
bitnami/minideb-extras:jessie-buildpack Buildpack (includes build-essential, git, etc.)


Use like a regular base image.

The following example uses the install_packages helper script, provided by minideb, to install APT packages from the Debian repositories. The bitnami-pkg tool to install nami packages published by Bitnami.

FROM bitnami/minideb-extras:jessie
RUN install_packages libssl1.0.0 libaprutil1 libapr1 libc6 libuuid1 libexpat1 \
      libpcre3 libldap-2.4-2 libsasl2-2 libgnutls-deb0-28 zlib1g libp11-kit0 \
      libtasn1-6 libnettle4 libhogweed2 libgmp10 libffi6
RUN bitnami-pkg install apache-2.4.25-0
CMD ["nami", "start", "--foreground", "apache"]

Configuration Parameters

The following tables lists the configurable parameters of the image.

Parameter Description
BASH_DEBUG Turn on bash debugging
NAMI_DEBUG Turn on nami debugging
DISABLE_WELCOME_MESSAGE Turn off the welcome text
DISABLE_LAUNCH_TRACKING Turn off update notifications and launch tracking

Turn on BASH debugging

Add BASH_DEBUG=1 to the container environment to enable BASH debugging which prints the commands being executed.

Turn on Nami debugging

To enable debugging add NAMI_DEBUG=1 to the container environment. The NAMI_DEBUG variable enables helpful logging and debugging features which can be valuable for debugging issues.

Turn off the welcome text

When a new container is launched, a welcome message is displayed as illustrated below:

 *** Welcome to the apache image ***
 *** Brought to you by Bitnami ***
 *** More information: ***
 *** Issues: ***

Adding DISABLE_WELCOME_MESSAGE=1 to the container environment turns off this message.

Turn off launch tracking

Bitnami tracks container launch data to help us understand which apps are popular and prioritize app development.

The launch data collected includes:

  • Image version in use
  • Registry (Dockerhub, etc.)
  • Platform (Kubernetes, etc.)
  • Cloud (GCE, AWS, etc.)

Container launch tracking is enabled by default and can be turned off by adding DISABLE_LAUNCH_TRACKING=1 to the container environment.


We'd love for you to contribute to this container. You can request new features by creating an issue or submitting a pull request with your contribution.


If you encountered a problem running this container, you can file an issue. Be sure to include the following information in your issue:

  • Host OS and version
  • Output of:
    • docker version
    • docker info
  • Steps to reproduce the issue
  • Logging information with debug mode enabled


Copyright 2015 - 2017 Bitnami

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.