From b9ad5afb3f56d2db5c4dad6557250b0b0d90e809 Mon Sep 17 00:00:00 2001 From: knmcguire Date: Wed, 5 Aug 2026 16:33:58 +0200 Subject: [PATCH 1/3] update ionic windows install Signed-off-by: knmcguire --- ionic/install_windows.md | 137 +++++++++++++++++++++++---------------- 1 file changed, 81 insertions(+), 56 deletions(-) diff --git a/ionic/install_windows.md b/ionic/install_windows.md index 5b544ad606..0a14e0a307 100644 --- a/ionic/install_windows.md +++ b/ionic/install_windows.md @@ -2,69 +2,94 @@ WARNING: Current Windows support is experimental. -# Binary Installation on Windows 10 - -Most Gazebo packages are available in Windows 10 using the [conda-forge package manager](https://conda-forge.org/), -and the Gazebo feedstock recipes can be found [here](https://github.com/search?q=org:conda-forge+libgz&type=code). - - -In order to use `conda-forge`, you will need to -1. Install a [Conda package management system](https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html). - Miniconda suffices. You will likely want to check the box to add `conda` to your `PATH` - during the installation process so that you won't have to do this step manually. - -2. Open a Windows command prompt, being sure to have `conda` added to your - Windows `PATH` system environment variable (you may also need to open - a new command prompt to see any `PATH` changes reflected). - - If you did not add Conda to your `PATH` environment variable - during Conda installation, you may need to navigate to the - location of `condabin` in order to use the `conda` command. - To find `condabin`, search for "Anaconda Prompt" in the - Windows search field near the Windows button, open it, run - `where conda`, and look for a line containing the directory `condabin`. - -3. Create and activate a new Conda environment: - ```bash - conda create -n gz-env - conda activate gz-env - ``` -4. Install desired Gazebo packages you want to install based on your application. Packages with the prefix `libgz-` - contain only the C++ libraries while the Python bindings are available separately as `gz-<#>-python`. - To install both with a single command use `gz-<#>`. - Thus you can use `gz-sim<#>` to fully install the latest version of Gazebo. - ```bash - conda install libgz-<#> --channel conda-forge - ``` - Be sure to replace `` with your desired package name (ie, common, msgs, etc.) - and `<#>` with the release version. If left unspecified, `conda-forge` will install the - most recently stable release packages. Be sure to check the - [high level install instructions](install) for corresponding version numbers. - -**Note** - -You can view all available versions of a specific package with: -```bash -conda search libgz-* --channel conda-forge -``` -and view their dependencies with +# Binary Installation on Windows 10/11 + +Binaries for all the dependencies used by Gazebo can be found in the [conda-forge](https://conda-forge.org/) +package repository. The Gazebo buildfarm and these instructions use the [Pixi](https://pixi.sh/) package manager. + +## Install dependencies + +1. Follow the Pixi installer instructions from https://pixi.sh/latest/ to install pixi. + Once pixi has been installed, close the terminal session and start it again, + which will ensure pixi is on the PATH. + +2. Make a folder to initialize the Pixi project. + Just make sure that the directory does not contain any spaces. + Open up a command prompt and type the following + ```bash + cd C:\Users\%USERNAME%\ + mkdir gz-ws + cd gz-ws + pixi init + ``` + You should see this: + + ```bash + ✔ Created C:\Users\USER\ws_gz\pixi.toml + ``` + +3. Prepare the pixi.toml file + Now that the Pixi environment has been installed, you can add the packaged gazebo binary to it and some necessary environment variables for the QT library. + + Open up the pixi.toml file in your editor of choice or simple notepad. + + ```bash + notepad pixi.toml + ``` + + Replace `[dependencies]` with the following in the pixi.toml file + + ``` + [target.win-64.activation.env] + QT_QPA_PLATFORM_PLUGIN_PATH="%CONDA_PREFIX%\\Library\\lib\\qt6\\plugins\\platforms" + QML2_IMPORT_PATH="%CONDA_PREFIX%\\Library\\lib\\qt6\\qml" + + [dependencies] + gz-sim = "9.*" + ``` + + Save and close the pixi.toml file, and then let Pixi pull all the dependencies and install Gazebo. + + ```bash + pixi install + ``` + You should be seeing this + + ``` + ✔ The default environment has been installed. + ``` + + +You should now be able to launch gazebo normally within a pixi shell: + ```bash -conda search libgz-* --channel conda-forge --info +pixi shell +gz sim -v4 shapes.sdf ``` -and install a specific minor version with + +or do a pixi run which is the same thing but just one line: + ```bash -conda install libgz-=.. --channel conda-forge +pixi run gz sim -v4 shapes.sdf ``` -where `` is the major release number, `` is the minor release number, and ` Note, currently just running `gz sim` directly doesn't work due to [this issue](https://github.com/gazebosim/gz-sim/issues/3859), so make sure to to always assign a world sdf file until this has been solved. -If you need to uninstall Gazebo or switch to a source-based install once you -have already installed the library from binaries, run the following command: -```bash -conda uninstall libgz- --channel conda-forge -``` +This is the end of the binary install instructions; head back to the [Getting started](getstarted) +page to start using Gazebo! + + +## Uninstalling binary-based gazebo install + +Uninstalling the Gazebo binary is as simple as removing the full folder that was created with the Pixi environment. + +In a command prompt, navigate to the root directory of where the folder is (depending on the location you chose at the first step), and remove it. + + ```bash + cd C:\Users\%USERNAME%\ + rmdir /s /q gz-ws + ``` ## Troubleshooting From ad1b24c5f3877b57d5f18d9b83b81dd7a2f7c104 Mon Sep 17 00:00:00 2001 From: knmcguire Date: Wed, 5 Aug 2026 16:41:50 +0200 Subject: [PATCH 2/3] update win install harmonic Signed-off-by: knmcguire --- harmonic/install_windows.md | 136 +++++++++++++++++++++--------------- 1 file changed, 80 insertions(+), 56 deletions(-) diff --git a/harmonic/install_windows.md b/harmonic/install_windows.md index 5b544ad606..4cf3d400fd 100644 --- a/harmonic/install_windows.md +++ b/harmonic/install_windows.md @@ -2,69 +2,93 @@ WARNING: Current Windows support is experimental. -# Binary Installation on Windows 10 - -Most Gazebo packages are available in Windows 10 using the [conda-forge package manager](https://conda-forge.org/), -and the Gazebo feedstock recipes can be found [here](https://github.com/search?q=org:conda-forge+libgz&type=code). - - -In order to use `conda-forge`, you will need to -1. Install a [Conda package management system](https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html). - Miniconda suffices. You will likely want to check the box to add `conda` to your `PATH` - during the installation process so that you won't have to do this step manually. - -2. Open a Windows command prompt, being sure to have `conda` added to your - Windows `PATH` system environment variable (you may also need to open - a new command prompt to see any `PATH` changes reflected). - - If you did not add Conda to your `PATH` environment variable - during Conda installation, you may need to navigate to the - location of `condabin` in order to use the `conda` command. - To find `condabin`, search for "Anaconda Prompt" in the - Windows search field near the Windows button, open it, run - `where conda`, and look for a line containing the directory `condabin`. - -3. Create and activate a new Conda environment: - ```bash - conda create -n gz-env - conda activate gz-env - ``` -4. Install desired Gazebo packages you want to install based on your application. Packages with the prefix `libgz-` - contain only the C++ libraries while the Python bindings are available separately as `gz-<#>-python`. - To install both with a single command use `gz-<#>`. - Thus you can use `gz-sim<#>` to fully install the latest version of Gazebo. - ```bash - conda install libgz-<#> --channel conda-forge - ``` - Be sure to replace `` with your desired package name (ie, common, msgs, etc.) - and `<#>` with the release version. If left unspecified, `conda-forge` will install the - most recently stable release packages. Be sure to check the - [high level install instructions](install) for corresponding version numbers. - -**Note** - -You can view all available versions of a specific package with: -```bash -conda search libgz-* --channel conda-forge -``` -and view their dependencies with +# Binary Installation on Windows 10/11 + +Binaries for all the dependencies used by Gazebo can be found in the [conda-forge](https://conda-forge.org/) +package repository. The Gazebo buildfarm and these instructions use the [Pixi](https://pixi.sh/) package manager. + +## Install dependencies + +1. Follow the Pixi installer instructions from https://pixi.sh/latest/ to install pixi. + Once pixi has been installed, close the terminal session and start it again, + which will ensure pixi is on the PATH. + +2. Make a folder to initialize the Pixi project. + Just make sure that the directory does not contain any spaces. + Open up a command prompt and type the following + ```bash + cd C:\Users\%USERNAME%\ + mkdir gz-ws + cd gz-ws + pixi init + ``` + You should see this: + + ```bash + ✔ Created C:\Users\USER\ws_gz\pixi.toml + ``` + +3. Prepare the pixi.toml file + Now that the Pixi environment has been installed, you can add the packaged gazebo binary to it and some necessary environment variables for the QT library. + + Open up the pixi.toml file in your editor of choice or simple notepad. + + ```bash + notepad pixi.toml + ``` + + Replace `[dependencies]` with the following in the pixi.toml file + + ``` + [dependencies] + gz-sim = "8.*" + ``` + + Save and close the pixi.toml file, and then let Pixi pull all the dependencies and install Gazebo + + ```bash + pixi install + ``` + You should be seeing this + + ``` + ✔ The default environment has been installed. + ``` + + + +You should now be able to launch gazebo normally within a pixi shell: + ```bash -conda search libgz-* --channel conda-forge --info +pixi shell +gz sim -v4 -s shapes.sdf ``` -and install a specific minor version with + +And in a second terminal + ```bash -conda install libgz-=.. --channel conda-forge +pixi shell +gz sim -g ``` -where `` is the major release number, `` is the minor release number, and ` Note, Gazebo Harmonic has a bug that it can not run the simulator in one session, it needs to be launched with the server and gui seperately. This bug has been fixed in later versions of Gazebo (Ionic and up) -```bash -conda uninstall libgz- --channel conda-forge -``` + +This is the end of the binary install instructions; head back to the [Getting started](getstarted) +page to start using Gazebo! + + +## Uninstalling binary-based gazebo install + +Uninstalling the Gazebo binary is as simple as removing the full folder that was created with the Pixi environment. + +In a command prompt, navigate to the root directory of where the folder is (depending on the location you chose at the first step), and remove it. + + ```bash + cd C:\Users\%USERNAME%\ + rmdir /s /q gz-ws + ``` ## Troubleshooting From 141f02833eb8bc378e0552d9887907f8b51463e0 Mon Sep 17 00:00:00 2001 From: knmcguire Date: Wed, 5 Aug 2026 16:46:41 +0200 Subject: [PATCH 3/3] updates win install instructions Signed-off-by: knmcguire --- harmonic/install_windows.md | 7 +------ ionic/install_windows.md | 13 +++++-------- jetty/install_windows.md | 11 ++++++----- 3 files changed, 12 insertions(+), 19 deletions(-) diff --git a/harmonic/install_windows.md b/harmonic/install_windows.md index 4cf3d400fd..d541394756 100644 --- a/harmonic/install_windows.md +++ b/harmonic/install_windows.md @@ -55,8 +55,6 @@ package repository. The Gazebo buildfarm and these instructions use the [Pixi](h ✔ The default environment has been installed. ``` - - You should now be able to launch gazebo normally within a pixi shell: ```bash @@ -71,14 +69,11 @@ pixi shell gz sim -g ``` - -> Note, Gazebo Harmonic has a bug that it can not run the simulator in one session, it needs to be launched with the server and gui seperately. This bug has been fixed in later versions of Gazebo (Ionic and up) - +> Note, Gazebo Harmonic has a bug that it can not run the simulator in one session, it needs to be launched with the server and gui separately. This bug has been fixed in later versions of Gazebo (Jetty and up) This is the end of the binary install instructions; head back to the [Getting started](getstarted) page to start using Gazebo! - ## Uninstalling binary-based gazebo install Uninstalling the Gazebo binary is as simple as removing the full folder that was created with the Pixi environment. diff --git a/ionic/install_windows.md b/ionic/install_windows.md index 0a14e0a307..432ae2c5df 100644 --- a/ionic/install_windows.md +++ b/ionic/install_windows.md @@ -59,27 +59,24 @@ package repository. The Gazebo buildfarm and these instructions use the [Pixi](h ✔ The default environment has been installed. ``` - You should now be able to launch gazebo normally within a pixi shell: ```bash pixi shell -gz sim -v4 shapes.sdf +gz sim -v4 -s shapes.sdf ``` -or do a pixi run which is the same thing but just one line: +And in a second terminal ```bash -pixi run gz sim -v4 shapes.sdf +pixi shell +gz sim -g ``` -> Note, currently just running `gz sim` directly doesn't work due to [this issue](https://github.com/gazebosim/gz-sim/issues/3859), so make sure to to always assign a world sdf file until this has been solved. - +> Note, Gazebo Harmonic has a bug that it can not run the simulator in one session, it needs to be launched with the server and gui separately. This bug has been fixed in later versions of Gazebo (Jetty and up) This is the end of the binary install instructions; head back to the [Getting started](getstarted) page to start using Gazebo! - - ## Uninstalling binary-based gazebo install Uninstalling the Gazebo binary is as simple as removing the full folder that was created with the Pixi environment. diff --git a/jetty/install_windows.md b/jetty/install_windows.md index 7a89711533..f9de8671d4 100644 --- a/jetty/install_windows.md +++ b/jetty/install_windows.md @@ -23,7 +23,7 @@ package repository. The Gazebo buildfarm and these instructions use the [Pixi](h pixi init ``` - You should see this: + You should see this: ```bash ✔ Created C:\Users\USER\ws_gz\pixi.toml @@ -55,6 +55,11 @@ package repository. The Gazebo buildfarm and these instructions use the [Pixi](h pixi install ``` + You should be seeing this + + ``` + ✔ The default environment has been installed. + ``` You should now be able to launch gazebo normally within a pixi shell: @@ -62,20 +67,16 @@ You should now be able to launch gazebo normally within a pixi shell: pixi shell gz sim -v4 shapes.sdf ``` - or do a pixi run which is the same thing but just one line: ```bash pixi run gz sim -v4 empty.sdf ``` - > Note, currently just running `gz sim` directly doesn't work due to [this issue](https://github.com/gazebosim/gz-sim/issues/3859), so make sure to to always assign a world sdf file until this has been solved. - This is the end of the binary install instructions; head back to the [Getting started](getstarted) page to start using Gazebo! - ## Uninstalling binary-based gazebo install Uninstalling the Gazebo binary is as simple as removing the full folder that was created with the Pixi environment.