package-managers.rst: add more distro PMs #662

junghans · 2025-04-14T15:19:06Z

No description provided.

nmm0

Looks good to me, though if we keep adding more distros we may want to format as a table rather than as prose :P

cedricchevalier19

I am not sure we want to advertise these packages without having tested them.
I had trouble with the kokkos debian's packaging before, and these packages can be pretty outdated (https://repology.org/project/kokkos/versions).

Can we check that the install is fine for us before merging this into the main documentation?

dalg24 · 2025-04-16T14:57:56Z

I expected we'd provide a description of the packages

junghans · 2025-04-16T15:32:03Z

@rbberger maintains the Fedora package. I think v4.6 isn't packaged as we wait for lammps to be bumped. I am also not sure why they list Fedora below 40 as they are all EOL'ed.

The debian package is @alexmyczko

openSUSE is PR driven.

junghans · 2025-04-16T15:48:34Z

Looks good to me, though if we keep adding more distros we may want to format as a table rather than as prose :P

Yeah, a table might be better, but I will leave that to somebody with more rst skills ;-)

docs/source/get-started/package-managers.rst

cedricchevalier19

I think it is better to advise not to use distribution packages for Kokkos as long as we have not "vetted/tested" them.

docs/source/get-started/package-managers.rst

junghans · 2025-04-17T15:46:29Z

I think it is better to advise not to use distribution packages for Kokkos as long as we have not "vetted/tested" them.

Distro	Command to install	Backend	Vetted	Maintainer	Build Source
Fedora	`dnf install kokkos-devel`	openMP, rocm, serial	a bit	@rbberger	here
Debian	`apt-get install libkokkos-dev`	openMP	a bit	@alexmyczko	here
Conda	`conda install conda-forge::kokkos`	openMP, serial, CUDA	nope	@carterbox	here
openSUSE	`zypper install kokkos-devel`	openMP, serial	nope	[email protected]	here
Gentoo	`emerge kokkos`	whatever enabled	a bit	@tamiko	here
Arch	`pacman -S kokkos`	Threads, serial	maybe	@carlosal1015	here
Mac Port	`port install kokkos-devel`	openMP, serial	no	@MarcusCalhoun-Lopez	here
Spack	`spack install kokkos`	whatever enabled	yes	@cedricchevalier19, @nmm0, @lucbv	here

junghans · 2025-04-17T16:52:41Z

Can one of you make the above table into rst?

carterbox · 2025-04-17T20:14:24Z

@junghans, your summary table needs correction. conda-forge uses threads for Windows and openMP for unix because msvc doesn't have good openmp support.

nmm0 · 2025-04-17T20:32:31Z

+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Distro   | Command to install                    | Backend              | Vetted | Maintainer                            | Build Source                                                                                             |
+==========+=======================================+======================+========+=======================================+==========================================================================================================+
| Fedora   | ``dnf install kokkos-devel``          | openMP, rocm, serial | a bit  | rbberger                              | `here <https://src.fedoraproject.org/rpms/kokkos/blob/rawhide/f/kokkos.spec>`_                           |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Debian   | ``apt-get install libkokkos-dev``     | openMP               | a bit  | alexmyczko                            | `here <https://salsa.debian.org/debian/kokkos/-/blob/master/debian/rules>`_                              |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Conda    | ``conda install conda-forge::kokkos`` | openMP, serial, CUDA | nope   | carterbox                             | `here <https://github.com/conda-forge/kokkos-feedstock/blob/main/recipe/build.sh>`_                      |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| openSUSE | ``zypper install kokkos-devel``       | openMP, serial       | nope   | `[email protected] <mailto:[email protected]>`_ | `here <https://build.opensuse.org/projects/science/packages/kokkos/files/kokkos.spec?expand=1>`_         |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Gentoo   | ``emerge kokkos``                     | whatever enabled     | a bit  | tamiko                                | `here <https://gitweb.gentoo.org/repo/gentoo.git/tree/dev-cpp/kokkos/kokkos-4.3.1.ebuild>`_              |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Arch     | ``pacman -S kokkos``                  | Threads, serial      | maybe  | carlosal1015                          | `here <https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=kokkos>`_                                  |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Mac Port | ``port install kokkos-devel``         | openMP, serial       | no     | MarcusCalhoun-Lopez                   | `here <https://github.com/macports/macports-ports/blob/master/devel/kokkos/Portfile>`_                   |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
| Spack    | ``spack install kokkos``              | whatever enabled     | yes    | cedricchevalier19, nmm0, lucbv        | `here <https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/kokkos/package.py>`_ |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+

@junghans (note I didn't correct anything on the table just converted it to rst)

carterbox

When switching from source to rendered view, the table doesn't appear on Github.

https://github.com/kokkos/kokkos-core-wiki/blob/c7c3ecf915aa9e5e42698afdc71423ea58e1be9f/docs/source/get-started/package-managers.rst

I assume that's because you're using some flavor of RST that GitHub doesn't know.

Otherwise, the content seems fine.

JBludau · 2025-04-21T13:45:49Z

what is our plan with respect to keeping this table updated? Do we want the respective maintainers to do it (and to they agree to doing this) or do we have someone who is curating this?

cedricchevalier19 · 2025-04-23T15:35:10Z

docs/source/get-started/package-managers.rst

+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Distro   | Command to install                    | Backend              | Vetted | Maintainer                            | Build Source                                                                                             |
+==========+=======================================+======================+========+=======================================+==========================================================================================================+
+| Fedora   | ``dnf install kokkos-devel``          | openMP, rocm, serial | a bit  | rbberger                              | `here <https://src.fedoraproject.org/rpms/kokkos/blob/rawhide/f/kokkos.spec>`_                           |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Debian   | ``apt-get install libkokkos-dev``     | openMP               | a bit  | alexmyczko                            | `here <https://salsa.debian.org/debian/kokkos/-/blob/master/debian/rules>`_                              |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Conda    | ``conda install conda-forge::kokkos`` | openMP (linux), Threads (windows), serial, CUDA | nope   | carterbox                             | `here <https://github.com/conda-forge/kokkos-feedstock/blob/main/recipe/build.sh>`_                      |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| openSUSE | ``zypper install kokkos-devel``       | openMP, serial       | nope   | `[email protected] <mailto:[email protected]>`_ | `here <https://build.opensuse.org/projects/science/packages/kokkos/files/kokkos.spec?expand=1>`_         |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Gentoo   | ``emerge kokkos``                     | whatever enabled     | a bit  | tamiko                                | `here <https://gitweb.gentoo.org/repo/gentoo.git/tree/dev-cpp/kokkos/kokkos-4.3.1.ebuild>`_              |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Arch     | ``pacman -S kokkos``                  | Threads, serial      | maybe  | carlosal1015                          | `here <https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=kokkos>`_                                  |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Mac Port | ``port install kokkos-devel``         | openMP, serial       | no     | MarcusCalhoun-Lopez                   | `here <https://github.com/macports/macports-ports/blob/master/devel/kokkos/Portfile>`_                   |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Spack    | ``spack install kokkos``              | whatever enabled     | yes    | cedricchevalier19, nmm0, lucbv        | `here <https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/kokkos/package.py>`_ |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+


I am not sure that we want to put this kind of table in the primary documentation:

Some information is targeted to end-users (what packages exist and if they are "vetted" or not)

Other information related to collaboration and contributions: maintainers, source link.

For the user, I would rather have a sentence explaining that Kokkos might be available in distribution packages. Still, we do not know their usability deeply for now, so we advise building from source.

However, having a page for packagers makes sense, but I am not sure that we want to duplicate a table that is mostly dynamically available on repology. Here, the "vetted" status might be more apparent. Currently, it is not obvious what "a bit" vs "maybe" means.

I disagree with the latter point, repology only provides the version packaged and the maintainer, the former we didn't include in our table, the latter is mostly wrong (e.g. [email protected]).

docs/source/get-started/package-managers.rst

Co-authored-by: Cédric Chevalier <[email protected]>

nischild · 2025-05-21T06:16:56Z

The Debian entry in the table might be misleading. The listed Kokkos package is not in a stable release. It is only in the unstable package repository. (https://tracker.debian.org/pkg/kokkos)
A Kokkos package is available through Trilinos in the stable Debian release. (https://tracker.debian.org/pkg/trilinos)

junghans · 2025-05-21T19:07:00Z

Hmm, maybe we should just have a list of packages, so folks can look up how they were built and then say "use at your own risk".

junghans · 2025-05-23T00:02:59Z

Adding @JBlaschke re: conda package.

tpadioleau · 2025-08-21T15:00:13Z

docs/source/get-started/package-managers.rst

+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| openSUSE | ``zypper install kokkos-devel``       | OpenMP, serial       | nope   | `[email protected] <mailto:[email protected]>`_ | `here <https://build.opensuse.org/projects/science/packages/kokkos/files/kokkos.spec?expand=1>`_         |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Gentoo   | ``emerge kokkos``                     | whatever enabled     | a bit  | tamiko                                | `here <https://gitweb.gentoo.org/repo/gentoo.git/tree/dev-cpp/kokkos/kokkos-4.3.1.ebuild>`_              |


Are we sure about the link ? I get a Path not found

tpadioleau · 2025-08-21T15:05:42Z

docs/source/get-started/package-managers.rst

+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Mac Port | ``port install kokkos-devel``         | OpenMP, serial       | no     | MarcusCalhoun-Lopez                   | `here <https://github.com/macports/macports-ports/blob/master/devel/kokkos/Portfile>`_                   |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Spack    | ``spack install kokkos``              | whatever enabled     | yes    | cedricchevalier19, nmm0, lucbv        | `here <https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/kokkos/package.py>`_ |


nmm0 · 2025-08-21T15:12:38Z

docs/source/get-started/package-managers.rst


-System package managers
+Package managers
 ~~~~~~~~~~~~~~~~~~~~~~~


Can we add a comment below here:

.. warning:: Only the Spack package below is maintained by Kokkos developers and is our only official supported package. Others may be used, but please contact the listed maintainers for any issues.

Just to make it extra clear that we can't commit to supporting all the OS packages?

dalg24 · 2025-08-21T15:17:50Z

docs/source/get-started/package-managers.rst

 Use your favorite package manager to install Kokkos.

-System package managers
+Package managers


Why are we dropping the distinction between system package managers and other package managers such as Spack and whatnot?

I am fine with the proposed version, we list all package managers and then do a focus on one of them, Spack.

You prefer to go back to only system package managers ?

nmm0 · 2025-08-21T15:24:43Z

docs/source/get-started/package-managers.rst

+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| Conda    | ``conda install conda-forge::kokkos`` | OpenMP (linux), Threads (windows), serial, CUDA | nope   | carterbox                             | `here <https://github.com/conda-forge/kokkos-feedstock/blob/main/recipe/build.sh>`_                      |
+----------+---------------------------------------+----------------------+--------+---------------------------------------+----------------------------------------------------------------------------------------------------------+
+| openSUSE | ``zypper install kokkos-devel``       | OpenMP, serial       | nope   | `[email protected] <mailto:[email protected]>`_ | `here <https://build.opensuse.org/projects/science/packages/kokkos/files/kokkos.spec?expand=1>`_         |


So we discussed this and think that we shouldn't put the maintainer info; for github usernames, it's not very clear how to contact them anyway; and for the one person who has an email it might be more annoying than helpful. We should instead have a link to the support for that package manager. E.g. for OpenSUSE there is https://bugzilla.opensuse.org/ and I think each distro has their own. That way if the maintainer changes we aren't directing people to the wrong person for support

package-managers.rst: add more distro PMs

70a59b7

junghans marked this pull request as ready for review April 16, 2025 13:10

masterleinad approved these changes Apr 16, 2025

View reviewed changes

nmm0 approved these changes Apr 16, 2025

View reviewed changes

cedricchevalier19 reviewed Apr 16, 2025

View reviewed changes

dalg24 reviewed Apr 16, 2025

View reviewed changes

docs/source/get-started/package-managers.rst Outdated Show resolved Hide resolved

dalg24 reviewed Apr 16, 2025

View reviewed changes

docs/source/get-started/package-managers.rst Outdated Show resolved Hide resolved

crtrott requested changes Apr 16, 2025

View reviewed changes

docs/source/get-started/package-managers.rst Outdated Show resolved Hide resolved

cedricchevalier19 requested changes Apr 17, 2025

View reviewed changes

docs/source/get-started/package-managers.rst Outdated Show resolved Hide resolved

JBludau reviewed Apr 17, 2025

View reviewed changes

docs/source/get-started/package-managers.rst Outdated Show resolved Hide resolved

junghans added 4 commits April 18, 2025 08:59

Update package-managers.rst

d4bc77f

Update package-managers.rst

f570b4d

Update package-managers.rst

e4ac621

Update package-managers.rst

c7c3ecf

junghans requested review from JBludau, alexmyczko, carterbox, cedricchevalier19, crtrott, dalg24, masterleinad and nmm0 April 18, 2025 15:02

carterbox approved these changes Apr 18, 2025

View reviewed changes

cedricchevalier19 reviewed Apr 23, 2025

View reviewed changes

Update docs/source/get-started/package-managers.rst

7f06483

Co-authored-by: Cédric Chevalier <[email protected]>

tpadioleau reviewed Aug 21, 2025

View reviewed changes

nmm0 requested changes Aug 21, 2025

View reviewed changes

dalg24 reviewed Aug 21, 2025

View reviewed changes

nmm0 reviewed Aug 21, 2025

View reviewed changes

JBludau mentioned this pull request Sep 2, 2025

Kokkos installation with Homebrew and AUR #719

Closed

	\| Spack \| ``spack install kokkos`` \| whatever enabled \| yes \| cedricchevalier19, nmm0, lucbv \| `here <https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/kokkos/package.py>`_ \|
	\| Spack \| ``spack install kokkos`` \| whatever enabled \| yes \| cedricchevalier19, nmm0, lucbv \| `here <https://github.com/spack/spack-packages/blob/develop/repos/spack_repo/builtin/packages/kokkos/package.py>`_ \|

package-managers.rst: add more distro PMs #662

Are you sure you want to change the base?

package-managers.rst: add more distro PMs #662

Conversation

junghans commented Apr 14, 2025

Uh oh!

nmm0 left a comment

Choose a reason for hiding this comment

Uh oh!

cedricchevalier19 left a comment

Choose a reason for hiding this comment

Uh oh!

dalg24 commented Apr 16, 2025

Uh oh!

junghans commented Apr 16, 2025

Uh oh!

junghans commented Apr 16, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cedricchevalier19 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

junghans commented Apr 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

junghans commented Apr 17, 2025

Uh oh!

carterbox commented Apr 17, 2025

Uh oh!

nmm0 commented Apr 17, 2025

Uh oh!

carterbox left a comment

Choose a reason for hiding this comment

Uh oh!

JBludau commented Apr 21, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

nischild commented May 21, 2025

Uh oh!

junghans commented May 21, 2025

Uh oh!

junghans commented May 23, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

junghans commented Apr 17, 2025 •

edited

Loading