Download an executable for Linux or Mac via Conda
=================================================

Binaries are available for MacOS or Linux via `Conda <conda_>`_.

First, one must setup the Conda package manager on your system.  Follow the
instructions to install `Miniconda <mini_conda_install_>`_, then create a conda
environment (named `my-lammps-env` or whatever you prefer) for your lammps
install:

.. code-block:: bash

   % conda config --add channels conda-forge
   % conda create -n my-lammps-env

Then, you can install lammps on your system with the following command:

.. code-block:: bash

   % conda activate my-lammps-env
   % conda install lammps

The LAMMPS binary is built with the :ref:`KIM package <kim>` which
results in Conda also installing the `kim-api` binaries when LAMMPS is
installed.  In order to use potentials from `openkim.org <openkim_>`_, you can
install the `openkim-models` package

.. code-block:: bash

   % conda install openkim-models

If you have problems with the installation you can post issues to
`this link <conda_forge_lammps_>`_.
Thanks to Jan Janssen (Max-Planck-Institut fuer Eisenforschung) for setting
up the Conda capability.

.. _conda_forge_lammps: https://github.com/conda-forge/lammps-feedstock/issues
.. _openkim: https://openkim.org
.. _conda: https://docs.conda.io/en/latest/index.html
.. _mini_conda_install: https://docs.conda.io/en/latest/miniconda.html
