# Install gmsh with Homebrew, apk, apt, dnf, MacPorts, Nix, winget, zypper

3D finite element grid generator with CAD engine. Version 4.15.2 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:gmsh
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gmsh
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gmsh
```

  Evidence: MacPorts ports tree: science/gmsh/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add gmsh
```

  Evidence: Alpine Linux edge package indexes: gmsh from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install gmsh
```

  Evidence: Debian stable package indexes: gmsh from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install gmsh
```

  Evidence: Fedora Rawhide package metadata: gmsh from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#gmsh
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gm/gmsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install gmsh
```

  Evidence: openSUSE Tumbleweed package metadata: gmsh from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id gmsh.gmsh -e
```

  Evidence: Windows Package Manager source index: gmsh.gmsh from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:gmsh
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gmsh>
- **Version:** 4.15.2
- **Source summary:** 3D finite element grid generator with CAD engine
- **Homepage:** <https://gmsh.info/>
- **Repository:** <https://gitlab.onelab.info/gmsh/gmsh>
- **Upstream docs:** <https://gmsh.info/doc/texinfo/gmsh.html>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://gmsh.info/src/gmsh-4.15.2-source.tgz>
- **Last updated:** 2026-06-22T14:03:35-07:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- gmsh (cli)
- gmsh (alias)

## Dependencies

- cairo
- fltk
- freetype
- gmp
- jpeg-turbo
- libomp
- libpng
- metis
- opencascade

## Build dependencies

- cmake
- eigen

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.15.2
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://gmsh.info/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Gmsh is an automatic three-dimensional finite-element mesh generator with CAD, meshing, solver, and post-processing modules. It is widely packaged because it serves both as a graphical scientific tool and as a scriptable/API-driven mesh generator for simulation workflows.

### Project history

Gmsh was created by Christophe Geuzaine and Jean-Francois Remacle, with copyright years in the source README beginning in 1997. The reference manual identifies it as a 3D finite-element mesh generator with built-in pre- and post-processing facilities.

The project was documented in a 2009 International Journal for Numerical Methods in Engineering paper, cited from the official manual. That paper helped establish Gmsh as a named research-software artifact rather than only a utility shipped by its authors.

Gmsh evolved from a standalone meshing program into a modular platform. The manual describes four modules: geometry, mesh, solver, and post-processing, controllable from the GUI, the command line, .geo scripts, and C++, C, Python, Julia, and Fortran APIs.

The 4.x line expanded API and CAD workflows, including OpenCASCADE geometry operations, model attributes, Fortran API support, and ongoing changes to mesh formats and post-processing behavior. The official version history records detailed 4.x releases through 4.15.2 in March 2026.

### Adoption history

The manual states that source code and precompiled binaries are distributed for Windows, macOS, and Linux, with packages also available in Linux and BSD distributions. The batch metadata additionally shows packaging in Homebrew, Alpine, Debian, Fedora, MacPorts, Nix, Ubuntu, winget, and openSUSE.

Gmsh's adoption rests on a useful balance: it is light enough to install as a command-line tool, visual enough for interactive geometry and mesh inspection, and programmable enough to sit inside automated simulation pipelines.

Its official documentation and examples make it attractive to finite-element practitioners who need mesh generation without adopting a full commercial preprocessor. The .geo scripting language and multi-language API also make meshes reproducible in source-controlled projects.

### How it is used

Practitioners use Gmsh to define geometry, generate 1D, 2D, and 3D meshes, assign physical groups, import CAD through OpenCASCADE, inspect mesh quality, and export mesh files for downstream solvers.

Command-line users generate meshes from .geo files in build pipelines or tests. GUI users inspect and tune geometry, mesh sizes, fields, and post-processing views. API users call Gmsh from C++, C, Python, Julia, or Fortran to generate meshes from application code.

Package-manager installs are especially useful for CI and scientific environments where scripts need the gmsh executable or Python module available without a manual GUI installer.

### Why package nerds care

Gmsh is a high-value package because it turns a hard scientific dependency into a normal system dependency. Build scripts, solver examples, Python notebooks, and finite-element tutorials can all assume an installable gmsh command rather than bundling a meshing engine.

It is also a good example of why scientific packages are often bigger than a CLI: one formula supplies a desktop app, CAD integrations, a shared library, language bindings, examples, and a file-format ecosystem.

### Timeline

- 1997: Gmsh copyright period begins in the source README.
- 2009: Gmsh paper published in International Journal for Numerical Methods in Engineering.
- 2017: Public GitLab project created on gitlab.onelab.info.
- 2022: Gmsh 4.11.0 added Fortran API support and new official macOS ARM builds.
- 2026: Gmsh 4.15.2 released.

### Related projects

- OpenCASCADE supplies CAD-kernel functionality for constructive solid geometry, boolean operations, and STEP import.
- ONELAB is related through the official hosting and solver-oriented workflows documented by Gmsh.
- Finite-element solvers consume the mesh files and physical groups produced by Gmsh.

### Sources

- <https://gitlab.onelab.info/api/v4/projects/gmsh%2Fgmsh>
- <https://gitlab.onelab.info/api/v4/projects/gmsh%2Fgmsh/repository/tags>
- <https://gitlab.onelab.info/gmsh/gmsh>
- <https://gitlab.onelab.info/gmsh/gmsh/-/raw/master/README.txt>
- <https://gmsh.info>
- <https://gmsh.info/doc/texinfo/gmsh.html>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $GMSH_HOME/<General.OptionsFileName>, $GMSH_HOME/<General.SessionFileName>, ~/<General.OptionsFileName>, ~/<General.SessionFileName>, <model-file>.opt
- Windows: %GMSH_HOME%\<General.OptionsFileName>, %GMSH_HOME%\<General.SessionFileName>, %APPDATA%\<General.OptionsFileName>, %APPDATA%\<General.SessionFileName>, <model-file>.opt
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gmsh
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - gmsh - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: gmsh from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator | https://gmsh.info
- Debian apt - gmsh-doc - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: gmsh-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator documentation | https://gmsh.info
- Debian apt - libgmsh-dev - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: libgmsh-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator development files | https://gmsh.info
- Debian apt - libgmsh-private-headers-dev - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: libgmsh-private-headers-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator development files | https://gmsh.info
- Debian apt - libgmsh4.13 - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: libgmsh4.13 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator shared library | https://gmsh.info
- Debian apt - python3-gmsh - 4.13.1+ds1-6: normalized package name match | Debian stable package indexes: python3-gmsh from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Three-dimensional finite element mesh generator Python 3 wrapper | https://gmsh.info
- Nix - gmsh: normalized package name match | nixpkgs package indexes: pkgs/by-name/gm/gmsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - gmsh - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: gmsh from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator | https://gmsh.info
- Ubuntu apt - gmsh-doc - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: gmsh-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator documentation | https://gmsh.info
- Ubuntu apt - libgmsh-dev - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libgmsh-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator development files | https://gmsh.info
- Ubuntu apt - libgmsh-private-headers-dev - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libgmsh-private-headers-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator development files | https://gmsh.info
- Ubuntu apt - libgmsh4.12t64 - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libgmsh4.12t64 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator shared library | https://gmsh.info
- Ubuntu apt - python3-gmsh - 4.12.1+ds1-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-gmsh from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Three-dimensional finite element mesh generator Python 3 wrapper | https://gmsh.info
- apk - gmsh - 4.15.0-r0: normalized package name match | Alpine Linux edge package indexes: gmsh from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Automatic 3D finite element mesh generator | https://gmsh.info/
- apk - gmsh-dbg - 4.15.0-r0: normalized package name match | Alpine Linux edge package indexes: gmsh-dbg from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Automatic 3D finite element mesh generator (debug symbols) | https://gmsh.info/
- apk - gmsh-doc - 4.15.0-r0: normalized package name match | Alpine Linux edge package indexes: gmsh-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Automatic 3D finite element mesh generator (documentation) | https://gmsh.info/


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Scientific computing packages](https://www.automicvault.com/pkg/scientific-computing-tools/) - Matched scientific computing metadata.
- [cairo](https://www.automicvault.com/pkg/brew/cairo/) - Runtime dependency declared by Homebrew.
- [fltk](https://www.automicvault.com/pkg/brew/fltk/) - Runtime dependency declared by Homebrew.
- [freetype](https://www.automicvault.com/pkg/brew/freetype/) - Runtime dependency declared by Homebrew.
- [jpeg-turbo](https://www.automicvault.com/pkg/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew.
- [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew.
- [metis](https://www.automicvault.com/pkg/brew/metis/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [tfel](https://www.automicvault.com/pkg/brew/tfel/) - Shares av.db curated category or tags: cli, engineering, science.
- [admesh](https://www.automicvault.com/pkg/brew/admesh/) - Shares av.db curated category or tags: cad, cli, science.
- [kim-api](https://www.automicvault.com/pkg/brew/kim-api/) - Shares av.db curated category or tags: api, cli, science.
- [opencascade](https://www.automicvault.com/pkg/brew/opencascade/) - Shares av.db curated category or tags: cad, cli, science.
- [aamath](https://www.automicvault.com/pkg/brew/aamath/) - Shares av.db curated category or tags: cli, science.
- [abpoa](https://www.automicvault.com/pkg/brew/abpoa/) - Shares av.db curated category or tags: cli, science.
- [abricate](https://www.automicvault.com/pkg/brew/abricate/) - Shares av.db curated category or tags: cli, science.
- [abyss](https://www.automicvault.com/pkg/brew/abyss/) - Shares av.db curated category or tags: cli, science.
- [siril](https://www.automicvault.com/pkg/brew/siril/) - Local package facts share a topical domain. Shared terms: cairo, cli, jpeg, jpeg-turbo, libomp.
- [astrometry-net](https://www.automicvault.com/pkg/brew/astrometry-net/) - Local package facts share a topical domain. Shared terms: cairo, cli, engine, jpeg, jpeg-turbo.
- [itk](https://www.automicvault.com/pkg/brew/itk/) - Local package facts share a topical domain. Shared terms: cli, freetype, jpeg, jpeg-turbo, libpng.

## Combined YAML source

View the package source record on GitHub. [combined/gmsh.yml](https://github.com/automic-vault/db/blob/main/combined/gmsh.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
