Differences

This shows you the differences between two versions of the page.

--- install:macos [2023/02/02 15:16] – casabella
+++ install:macos [2026/09/17 12:17] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 The latest release 4.9 should work on all Mac OS versions greater or equal to 11. The installation requires a couple of steps (of which you have maybe done some already for other reasons):
   * Install the xcode command line tools
-  * (for some versions) install SDK headers
   * install Homebrew
   * install Perlbrew
@@ Line 20: / Line 19: @@
 <code>xcode-select --install</code>
 Either this tells you that your command line tools are installed or opens a small window that asks you whether you want to install them. Confirm. It also offers to install the full XCode IDE. This is **not** necessary and **not** recommended (you then need to install the command line tools on top from within XCode).
-Then, you should type
-<code>
-export CPATH=/Library/Developer/CommandLineTools/SDKs/MacOSX10.15.sdk/System/Library/Perl/5.18/darwin-thread-multi-2level/CORE/
-</code>
-and do all following steps in this terminal (or repeat the export command, if you open a new one).
 ==== Install Homebrew ====
@@ Line 43: / Line 36: @@
 </code>
-Now add some paths to your Terminal config and reload the config. Type the following lines in the terminal:
+We have to add some variables to the shell environment. Recent macs usually use ''zsh'' as their shell. You can check this with
+<code>
+echo $SHELL
+</code>
+If you use ''bash'', you have to
+  * replace ''.zshrc'' with ''.bashrc'' in the terminal commands below
+  * add <code>if [ -f ~/.bashrc ]; then . ~/.bashrc; fi </code> at the end of the file ''$HOME/.bash_profile'' if it is not already present
+Now add some paths to your Terminal config and reload the config. For an Intel Mac type the following lines in the terminal:
 <code>
 echo "export PERL5LIB=$HOME/perl5/lib/perl5:$HOME/perl5${PERL5LIB+:$PERL5LIB}" >> $HOME/.zshrc
@@ Line 50: / Line 51: @@
 source $HOME/.zshrc
 </code>
+and for a Silicon Mac use
+<code>
+echo "export PERL5LIB=$HOME/perl5/lib/perl5:$HOME/perl5${PERL5LIB+:$PERL5LIB}" >> $HOME/.zshrc
+echo "source ~/perl5/perlbrew/etc/bashrc" >> $HOME/.zshrc
+echo 'export ARCHFLAGS="-arch arm64"' >> $HOME/.zshrc
+source $HOME/.zshrc
+</code>
 ==== Install dependencies with Homebrew ====
@@ Line 65: / Line 74: @@
 brew install ninja
 brew install ccache
+brew install mongo-c-driver
+brew install jupyterlab
 </code>
@@ Line 74: / Line 85: @@
 cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)
 cpanm SVG
-cpanm Moo
-cpanm MongoDB
 cpanm JSON
 cpanm install Net::SSLeay
 cpanm Term::ReadLine::Gnu
+cpanm Term::ReadKey
+cpanm XML::SAX
 </code>
-==== Install a python dependence ====
-<code>
-pip3 install jupyter --user
-</code>
-This may complain about a path not being set. If so, add this to your $PATH-variable.
 ==== Download polymake ====
@@ Line 95: / Line 100: @@
 <code>
 cd Downloads
-tar -xvfj polymake-4.9.tar.bz2
+tar -xvjf polymake-4.13.tar.bz2
 </code>
 ==== Configure and install polymake ====
-Essentially, polymake is compiled and installed with the following commands. This will put the polymake binary into ''/usr/local''. You may have to use ''sudo'' for installing.
+=== Compilation ===
+Finally, we can compile and install polymake. This requires one more choice on your side.
+  - You may opt to install polymake into the standard installation location for additional software on your computer. This will place the compiled version of polymake into the directory ''/usr/local''.
+  - You may also provide a separate directory in your home folder for the compiled version of polymake.
+For the first option you will need administrator permissions for your computer and probably prefix the commands below with ''sudo''. The advantage of this choice is, that ''/usr/local/'' is contained in the search path for programs, and polymake will directly be found.
+Advantage of the second option is, that you do not need administrator permissions for the installation, and have all files related to polymake in one location. This makes it easier to install new versions or remove polymake. We strongly recommend the second option.
+If you opt to install into a subfolder of your home folder, then please create one before proceeding. For this, create a folder with
 <code>
-cd ~/Downloads/polymake-4.9
+mkdir $HOME/<polymake_install_folder>
-./configure --without-java
-ninja -C build/Opt -j2 install
 </code>
+where ''<polymake_install_folder>'' is a name of your choice, e.g. ''polymake_bin''. You will need the name of the folder for the commands below.
-However, we recommend to install into a directory in your $HOME-folder. For this, create a folder with
+In the command below, you will also need to replace all occurences of ''<brew-install-location>'' by
+  * ''/usr/local/'' if you have an Intel Mac and installed brew in the default location
+  * ''/opt/homebrew'' if you have an M1/M2/M3 Mac and installed brew in the default location
+  * with the directory you installed brew into, if you chose a nonstandard location for the installation
+Finally, we can compile polymake. If you chose option 1. above, then compile with:
 <code>
-mkdir $HOME/<polymake_install_folder>
+cd ~/Downloads/polymake-4.13
+./configure --without-java --with-brew=<brew-install-location>
+ninja -C build/Opt -j2 install
 </code>
-where ''<polymake_install_folder>'' is a name of your choice, e.g. ''polymake_bin''. Then compile and install with (replace with the correct folder name!)
+If you chose option 2., then compile with
 <code>
-cd ~/Downloads/polymake-4.9
+cd ~/Downloads/polymake-4.13
-./configure --without-java --prefix=$HOME/<polymake_install_folder>
+./configure --without-java --with-brew=<brew-install-location> --prefix=$HOME/<polymake_install_folder>
 ninja -C build/Opt -j2 install
 </code>
@@ Line 124: / Line 144: @@
 $HOME/<polymake_install_folder>/bin/polymake
 </code>
-or add ''$HOME/<polymake_install_folder>/bin/'' to your path.
+or just
+<code>
+polymake
+</code>
+if you chose option 1.. For option 2., if you first do
+<code>
+export PATH=$PATH:''$HOME/<polymake_install_folder>/bin/''
+</code>
+in a terminal, then you can also start polymake by just typing ''polymake''. You can add this line also at the end of the file ''$HOME/.zshrc'' to add the polymake installation folder to the path permanently.
+=== Configuration ===
+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.