Linux¶

Supplement, not a second guide

Follow Installation. This page adds only what is specific to Linux.


Last validated	not yet — see the checklist below
Validated by	—
Hardware / distro	—

Install Conda¶

wget -O Miniforge3.sh "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3.sh -b -p "$HOME/miniforge3"
source "$HOME/miniforge3/etc/profile.d/conda.sh"
conda init bash          # or: conda init zsh

Reopen the terminal, then continue at step 2.

OpenGL libraries¶

MuJoCo rendering needs GL libraries that a minimal install may not have:

sudo apt-get install -y libgl1-mesa-glx libosmesa6 libglew-dev libglfw3

Headless machines¶

No display attached — a server, a VM, an SSH session — means no on-screen window. Off-screen rendering still works, and .mp4 export is unaffected:

export MUJOCO_GL=osmesa        # or: egl, if the machine has an NVIDIA GPU
python scripts/smoke_test.py

See GLFWError / black render window.

Validation checklist¶

Task A3 on the volunteer board. Work through Installation on a machine that has never had the environment, recording every point where you had to guess.

Conda installs and conda activate rlbootcamp works in a fresh shell
conda env create -f environment.yml completes without manual fixes
python scripts/smoke_test.py is all ok
jupyter lab opens and a cell runs on the rlbootcamp kernel
Headless case: MuJoCo renders and .mp4 export works with no display
Every deviation is either fixed here or added to troubleshooting