====== polymake Downloads ======

Legal Disclaimer:

By downloading polymake in any form (whether source code or compiled) you agree to be bound by the GPL license agreement, [[http://www.gnu.org/licenses/gpl-2.0.html|version 2]] or (at your option) any [[http://www.gnu.org/licenses/gpl.html|later version]]; further you renounce to claim any kind of warranty or damages related to the use of this software.

Software libraries [[:external_software#essential_libraries_bundled_with_polymake|bundled with polymake]] are protected by open source licenses adequate to the GPL or broader. However, the exact wording and restrictions to use may vary.  Please consult the corresponding ''COPYING'' or ''README'' files included in the ''external'' subdirectory of the distribution.

Support queries concerning installation and usage are welcome (please use our [[http://forum.polymake.org|forum]]), as well as any other feedback, but are served on voluntary base, depending, first of all, on the authors' free time resources.

===== Online version =====

A polymake newbie? Installation problems? Just curious?
**[[:boxdoc|Try polymake online]]**!
The online version runs as a "shell in a box" in your browser. No installation needed! \\ Examples of ''polymake'' code are available on the [[user_guide:start|tutorial page]]. Notice that the online version comes with a few restrictions (including missing visualization) compared to the complete version.

===== Get latest stable release: 4.13 =====
Stable versions are released on a regular basis and offer the complete functionality of ''polymake'' available at the point of release. You can read about new features in the release notes [[:news/release_4_13|here]].

==== Linux, FreeBSD, Solaris, or other UNIX systems ====
=== To build polymake yourself ===
   * Read the [[install:install|Installation instructions]]
   * Download the {{:download:polymake-4.13.tar.bz2|source tarball}}

== Minimal version ==
The minimal version is a packager friendly version which omits the bundled sources of ''cdd'', ''lrs'', ''libnormaliz'', ''nauty'' and ''jReality''.
   * Download the {{:download:polymake-4.13-minimal.tar.bz2|minimal source tarball}}

== Zenodo ==
The polymake sources are also available on [[https://zenodo.org/doi/10.5281/zenodo.4428242|Zenodo]].

=== polymake ready to run ===
We now provide [[install:jll|prebuilt tarballs]] that can be extracted and run on Linux and macOS.

=== MaPS ===
You can also install polymake using the [[https://github.com/aaruni96/maps|MaPS]] system.

First get polymake using
<code>
maps --deploy org.polymake.polymake/x86_64/4.10
</code>
Then run this container using
<code>
maps --run org.polymake.polymake/x86_64/4.10
</code>

==== MacOS ====

**NOTE**: Provision of binaries is currently limited. Building from the sources has been tested and works. You can just use [[https://github.com/apaffenholz/homebrew-polymake|our homebrew tap]] or follow the instructions below. 

=== Binary Releases ===

You have two options: Install via [[https://github.com/apaffenholz/homebrew-polymake|our tap]] for [[https://brew.sh/|Homebrew]], or use the [[install:jll|polymake ready to run tarballs]].

== Homebrew ==

If you have installed [[https://brew.sh/|Homebrew]] already (or just do it by copying the one line from their page), you can get polymake via our tap.

**Note**: If you have previously installed a self compiled version of polymake into the standard installation location ''/usr/local'', then you **must** delete this version first (also if you used ''brew'' for the installation of dependencies, but not for ''polymake'' itself, as was the recommend procedure until 2020). Otherwise ''brew'' will refuse to install the executable, which leaves you with a broken polymake.
<code>
brew tap apaffenholz/polymake
brew install polymake
</code>
The formula has binaries for Intel/Monterey, Intel/Sonoma and M1/Sonoma (thanks to the [[https://www.sagemath.org/|sage project]]). All other variants compile polymake from the sources. 

**Note**: if you already **have or had a version of polymake installed** on your Mac you must reconfigure ''polymake'' on the first start with 
<code>
polymake --reconfigure
</code>

=== Source Installation === 

Read the [[install:macos|Installation instructions]] on how to compile the current version of polymake yourself.

=== Visualization ===

If you use ''Safari'' as your default browser, then you need to switch to another one for polymake. Please do
<code>
set_custom $Visual::webbrowser=open -a "Firefox"
</code>
inside the polymake shell. Replace ''Firefox'' by ''Google Chrome'' if you prefer this browser.

===== Debian, Fedora, Gentoo, Ubuntu =====

We are proud to announce that ''polymake'' is also part of the package library of the Debian, Fedora, Gentoo and Ubuntu distributions and can be installed from their corresponding package managers. Thanks to the maintainers!
   * On Debian or Ubuntu, try <code>sudo apt-get install polymake</code>
   * On Fedora, try <code>sudo dnf install polymake</code>
   * On Gentoo, try <code>su
emerge -p polymake
emerge polymake</code>

**Remark:** The **[[:callable|callable library]]** version is part of any ''polymake'' source release but might not be included in all versions distributed via packaging systems.

=====Windows 10 with the Linux Subsystem=====
The preferred way to install ''polymake'' in Windows 10 systems is under the [[https://docs.microsoft.com/en-us/windows/wsl/install-win10|Linux Subsystem]]. Both Ubuntu and Debian have ''polymake'' in their repositories. Install Ubuntu under Windows 10, then download the Ubuntu package with

  sudo apt-get install polymake
  
This version may not be up to date. If you need the latest version, install the stable release from sources as explained in the previous section.

**Remark:** Visualization in the Linux Subsystem does not work out of the box
because of several issues. The current workaround is to load {{:download:wslviewer.pl | this polymake script }} that adapts the paths and uses a native windows program for opening the resulting file, which requires Windows 10 version 1903. You may load this script automatically at the beginning of every polymake session by adding a line
<code>script("$ENV{HOME}/path/to/wslviewer.pl");</code> to your personal startup file ''$HOME/.polymake/prefer.pl'' file (since polymake 4.4 this file is renamed to ''init.pl'' and must be activated via custom variable ''$init_script'').  Please be aware that this script is still //work in progress// and works only for threejs, tikz and svg at the moment.

=====Docker images=====
Docker allows to run a pre-built image on Linux, Mac OS, and since recently also Windows.  Our images are built every night from the stable master branch and come along with virtually all additional [[:external_software|third-party software]] recommended for computational tasks.  Please read the [[install:dockerimage|detailed instructions]] to become aware of known caveats and limitations.  Download the {{ :download:polymake-in-container.sh |starter script}} and enjoy the latest and greatest stable polymake snapshot instantaneously.

=====polymake in Julia=====
There is a dedicated interface [[:polymakejl|Polymake.jl]] for using polymake from Julia.

=====GitHub=====
The polymake releases can also be found on [[https://github.com/polymake/polymake|github]].

===== Other Downloads =====
  *  Information about external software used in ''polymake'' is located [[:external_software|here]].
  * Extensions  to ''polymake'' for specific tasks can be found [[:extensions|here]]
  * Data in polymake format is collected [[:polydb|here]]. 
  * Older polymake downloads can be found [[:download:versions|here]].