Mise à jour de SageMath sur macOS

Pour installer une version plus récente, suivre les étapes ci-après en omettant celles qui sont superflues.
Une fois la nouvelle version installée et testée, on peut supprimer l’ancienne, ce qui fera gagner de la place.
(On peut avoir plusieurs versions en même temps, mais c’est déconseillé sauf besoin spécifique.)

Installation de SageMath sur macOS (à faire 1 seule fois)

[Entre crochets, les noms à la date indiquée.]

Attention : L’app Sage Math qu’on peut trouver dans l’App Store ne doit pas être utilisée. Il s’agit d’une app pour iPad très ancienne (2017), qui n’est qu’un “emballage” faisant les calculs sur SageMathCell. Le cas échéant, il vaut mieux accéder directement à SageMathCell avec un navigateur.

  1. Compte “Admin”. L’installation doit être faite avec un compte “Admin” (et non un compte “Standard”).
    Ensuite, il devrait être possible d’utiliser SageMath depuis d’autres comptes (à vérifier).
  2. Mise à jour de macOS. Ces instructions ont été testées (de façon minimale) avec macOS 10.13 et suivants.
    Si possible, il est conseillé de mettre à jour macOS vers la version la plus récente disponible, en excluant la toute dernière.
    [2025-12-23 : macOS 15.7.3 ou sinon 14.8.3 ou sinon 13.7.8 ou sinon 12.7.6 ou sinon 11.7.10 ou sinon 10.15.7 ou sinon 10.13.6]
    Pour connaître la version idoine de macOS on peut utiliser Mactracker (https://mactracker.ca, Download > Standalone, l’ouvrir puis This Mac > Software).
    Pour mettre à jour vers une version ancienne, voir https://support.apple.com/fr-fr/102662.
  3. Navigateur. Pour les macOS anciens (10.12, 10.13 ou 10.14), le seul navigateur mis à jour et utilisable (au moins jusqu’au 2026-02-28) est Firefox version 115 ESR, disponible sur https://firefox.com.
  4. Aller dans le dossier ~/Documents, et y créer un nouveau dossier appelé SageMath.
  5. Aller à
    https://github.com/3-manifolds/Sage_macOS/releases
    et repérer la version stable la plus récente (ne pas prendre une version Pre-release).
    [2025-12-23 : SageMath-10.8 - v2.8.1].
  6. Dans Assets, cliquer pour télécharger : [2025-12-23 : SageMath-10.8_arm64.dmg ou SageMath-10.8_x86_64.dmg]
  7. Ouvrir le fichier DMG téléchargé.
  8. Copier l’application SageMath-⋯.app dans le dossier /Applications.
    [2025-12-23 : SageMath-10-8.app]
  9. Attendre la fin de la copie, puis ouvrir Recommended_⋯.pkg et l’installer, en répondant Yes à toutes les questions.
    [2025-12-23 : Recommended_10_8.pkg]
  10. Éjecter l’image disque SageMath-⋯, par exemple en cliquant ⏏ [2025-12-23 : SageMath-10.8].
  11. Première ouverture.
    Elle peut prendre beaucoup de temps (selon l’ancienneté de l’ordinateur), il conviendra d’être patient…
    Aller dans le dossier /Applications, ouvrir SageMath-⋯.app [2025-12-23 : SageMath-10-8.app].
  12. « SageMath-10-8.app » est une app téléchargé d’internet. Voulez-vous vraiment l’ouvrir ?
    Cliquer Ouvrir.
    « SageMath-10-8.app » demande l'autorisation de contrôler « Finder.app ».
    Cliquer Autoriser.
    « SageMath-10-8.app » demande l'autorisation de contrôler « System Events.app ».
    Cliquer Autoriser.
    « SageMath-10-8.app » demande l'autorisation de contrôler « Terminal.app ».
    Cliquer Autoriser.
  13. Cliquer Notebook, choisir JupyterLab (et non Jupyter Notebook), cliquer Select …, chosir le dossier ~/Documents/SageMath, cliquer Choose.

Utilisation de SageMath sur macOS

  1. Aller dans /Applications, ouvrir SageMath-⋯.app.
  2. Cliquer Launch. Cela ouvrira le navigateur par défaut (Firefox, Google Chrome, Opera, Safari, etc.).
  3. Choisir File > New Launcher, cliquer Notebook > SageMath ⋯. Cela affichera un nouveau cahier Jupyter.
Les fichiers (cahiers Jupyter avec extension .ipynb, etc.) se trouveront dans le dossier ~/Documents/SageMath.

Dépannage

En cas d’erreur de connexion à http://localhost:8888/lab, une possible solution radicale est d’aller dans ~/Library et effacer le contenu du dossier SageMath-⋯
[2025-12-23 : ~/Library/SageMath-10-8]
Ceci ne supprimera aucun fichier personnel, mais en revanche on devra refaire les étapes 11 à 13 de l’installation.