miniforge

This repository holds a minimal installer for conda specific to conda-forge. It is comparable to Miniconda, but with

• conda-forge set as the default channel
• an emphasis on supporting various CPU architectures

Miniforge installers are available here: https://github.com/conda-forge/miniforge/releases

Latest installers with python 3.8 in the base environment

• linux-aarch64 (also called arm64)
• linux-ppc64le (also called POWER8/9)
• linux-x86_64 (also called amd64)
• osx-x86_64
• osx-arm64 (Apple Silicon)
• win-x86_64

Latest installers with pypy3.6 in the base environment

• linux-aarch64
• linux-ppc64le
• linux-x86_64
• osx-x86_64

Follow the aarch64 and ppc64le migration status here: https://conda-forge.org/status/

To install download the installer and run,

bash Miniforge3-Linux-x86_64.sh   # or similar for other installers for unix platforms

or if you are on Windows, double click on the installer.

For non-interactive usage, look at the options by running the following

bash Miniforge3-Linux-x86_64.sh -h   # or similar for other installers for unix platforms

or if you are on windows, run:

start /wait "" build/Miniforge3-Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%\Miniforge3

Latest installers with mamba and Python 3.8 in the base environment

• linux-aarch64 (also called arm64)
• linux-ppc64le (also called POWER8/9)
• linux-x86_64 (also called amd64)
• osx-x86_64
• osx-arm64 (Apple Silicon)

• Automatic build of constructor.
• Automatic upload of constructor results.
• Automatic testing of constructor.
• Integration with conda-forge's developer documentation.
• Integration with conda-forge's official site.
• Upstream to Anaconda ?

After construction on Travis, the installer is tested against a range of distribution that match the installer architecture ($ARCH). For example when architecture is aarch64, the constructed installer is tested against:

• Centos 7
• Debian Buster (10)
• Ubuntu 16.04
• Ubuntu 18.04
• Ubuntu 19.10
• Ubuntu 20.04

Installers are built and uploaded via Travis but if you want to construct your own Miniforge installer, here is how:

# Configuration
export ARCH=aarch64
export DOCKERIMAGE=condaforge/linux-anvil-aarch64

bash build_miniforge.sh

To release a new version of Miniforge:

• Make a new pre-release on GitHub with name $CONDA_VERSION-$BUILD_NUMBER
• Wait until all artifacts are uploaded by CI
  • For each build, we upload 3 artifacts
    1. One installer with the version name
    2. One installer without the version name
    3. The SHA256
  • At the time of writing, the is a sum of 60 artifacts, and with the two sources, we expect a grand total of 62 artifacts.
• Mark the pre-release as a release

NOTE: using a pre-release is important to make sure the latest links work.

BSD 3-Clause

Relevant conversations:

• conda-forge/conda-forge.github.io#871 (comment)
• conda-forge/conda-forge.github.io#922