Quick Download and Installation Guide

Not sure what to download? This short guide should get you started.

  1. Determine your operating system. (Windows, Linux, macOS, Windows, etc.)
  2. Determine your CPU type. (If you are running a 32-bit operating system on a 64-bit CPU, choose the 32-bit version.)
  3. Do you want a source or binary distribution? A binary distribution is faster to install. If you want to do any development, we recommend to install Sage from source, although a precompiled version of Sage (binary release) can also be used for that purpose. Another advantage of compiling Sage from source is that the generated code may make better use of your specific CPU.
    • For macOS, there is the additional choice between a native Mac application (app bundle) and a Unix-style command line like for Linux, Solaris, etc. Both are full versions of Sage, containing both command line and notebook, but the Mac app has some extra features and is double-clickable without further effort.
  4. If available, choose the appropriate binary version from one of the download mirrors.

  5. Follow
    1. the binary installation guide to actually install a precompiled version of Sage, or

    2. the source installation guide for more detailed information on compiling Sage from source.


BitTorrent (or just "Torrent") is a peer-to-peer communication protocol for transferring huge amounts of data securely and efficiently over the internet. This is probably the best option for downloading Sage, make sure that your BitTorrent-Client supports "web-seeds".

Recommended clients are:

The provided torrent files contain web-seeds which are technologically equivalent to Metalink files. Make sure your torrent client understands web-seeds (e.g. all based on libtorrent do so).


  1. If no binary version is available for your system, download the source version. Note that Sage compiles on a wide variety of systems, but does not compile on every system.

  2. If you are not sure how to unpack the compressed file or its ending looks different:
    • *.tar.gz or *.tgz: Use tar xzf *.tar.gz

    • *.tar.bzip2 or *.tar.bz2: Use tar xjf *.tar.bzip2

    • *.app.dmg or *.dmg: This is a Mac disk image, and you can just double-click it.

    • *.tar.lzma: Use tar --lzma -xf *.tar.lzma

      • No lzma? Perhaps you have xz, that is compatible with lzma. There might also be -J in tar -xJf *.tar.lzma or you need to install an lzma or xz-utils package.

    • If the file ending is different, the Linux command file gives you information about the archive type. (Type file filename.ext at the command prompt.)

  3. The Release tour corresponding to the Sage version that you wish to install may offer version-specific installation help that has become available after the release was made and is therefore not covered by the installation manual.

  4. Ask for help on the sage-support mailing list.

DownloadAndInstallationGuide (last edited 2020-05-04 19:27:22 by mkoeppe)