Skip to content

Miniconda

Miniconda

Category: Development Type: Software Installer Tags: miniconda · python

Overview

The Miniconda plugin provides a lightweight, self-contained Python environment management solution for project workstations. It installs Miniconda to a shared persistent volume, creates a named conda environment with a specified Python version, and optionally installs additional packages. All workstations in the project that mount the shared volume can immediately use the managed conda environment without any additional setup.

How It Works

Software Installer — When added to a project, Terra downloads Miniconda, installs it to the shared volume you choose, and creates the configured conda environment with the packages you specify. The environment is then available to all workstations in the project that mount the volume.

Prerequisites

  • A shared persistent volume provisioned in your project
  • Outbound internet access from the cluster (to download the Miniconda installer and conda packages)

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Miniconda"
  3. Click Install
  4. Fill in the configuration fields below
  5. Click Confirm to deploy

Configuration

Install-Time Fields

Field Details
install_volume shared-volume · Required
Shared persistent volume to install Miniconda into
destination string · Optional · Default: /miniconda
Directory path within the volume for the Miniconda installation
environment_name string · Required · Default: base
Name of the conda environment to create
python_version string · Required · Default: 3.12
Python version to use in the conda environment (e.g. 3.10, 3.11, 3.12)
packages string · Optional · Default: ""
Space-separated list of additional conda/pip packages to install (e.g. numpy pandas scikit-learn)
source_url string · Optional
Custom URL to the Miniconda installer script (overrides the default download source)

Notes

  • Miniconda is a minimal installer for conda — it includes only conda, Python, and a small set of useful packages. Additional packages are installed via the packages field or within workstations using conda install
  • The source_url field is useful for air-gapped environments that mirror installer scripts internally
  • To use the conda environment from workstations, activate it with conda activate <environment_name> or reference the full path at <destination>/envs/<environment_name>/bin/python
plugins/miniconda/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
resource_id: miniconda
name: Miniconda
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/miniconda/scripts/assets/logo.png
description: |
  The Miniconda plugin provides a lightweight Python environment for users to manage their 
  Python dependencies and environments. It allows users to create isolated Python environments, 
  install packages, and manage their Python projects efficiently.
category: Development
tags:
  - miniconda
  - python
fields:
  - name: destination
    description: Destination directory
    required: false
    default: /miniconda
  - name: install_volume
    description: The name of the install volume
    required: true
    type: shared-volume
  - name: environment_name
    description: Name of the conda environment to create
    required: true
    default: base
  - name: packages
    description: Additional packages to install. You can use spaces " " to install multiples.
    required: false
    default: ""
  - name: python_version
    description: Python version to install in the conda environment (e.g., 3.8, 3.9, 3.10)
    required: true
    default: "3.12"
  - name: source_url
    description: | 
      URL to the Miniconda installer script. If not provided, the plugin will use the default 
      Miniconda installer for Linux.
    required: false
    default: "https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh"