# Platform Specific Instructions for Official Binaries

All official Julia binaries produce portable installations. Once installed, the directory in which Julia was installed can be moved to a different location on the same computer, or even to a different computer.

## Windows

Julia is available for Windows 7 and later, both 32 bit and 64 bit.

1. Download the Windows julia.exe installer for your platform. 32-bit julia works on both x86 and x86_64. 64-bit julia will only run on 64-bit Windows (x86_64).
3. At the “Choose Installation directory” step, copy the Path in the “Destination Folder” into a Notepad or similar file for future reference, and finish installation.
4. At this point, you can decide whether you want to invoke Julia by simply typing julia in the command line, or paste the entire path you saved in the Notepad. To invoke Julia by simply typing julia in the command line, perform the following steps.

If on Windows 10,

1. Hit (Windows Key + R) to open run, and type in sysdm.cpl and hit enter. This will open up the System Properties. Click on the “Advanced” tab.
2. Now, click the “Environment Variables…” button.
3. Under the “System Variables” section (the lower half), find the row with “Path” in the first column, and click edit.
4. The “Edit environment variable” UI will appear. Here, click “New”, and paste in the text you copied into the Notepad.
5. Hit OK and dismiss all the dialogs. You can now run Julia from the command line!

Else, if on Windows 7 or 8,

1. Hit (Windows Key + R) to open run, and type in sysdm.cpl and hit enter. This will open up the System Properties.
2. In the System Properties window, click the Advanced tab, and then click “Environment Variables”.
3. In the System Variables window, highlight Path, and click Edit.
4. In the Edit System Variables window, move the cursor to the end of the field.
5. If there is no semicolon at the end, add it and paste in the text you copied into the notepad.
6. Hit OK and dismiss all the dialogs. You can now run Julia from the command line!

Windows 7 / Windows Server 2012 users will also need to install:

It is recommended that users on these legacy Windows systems install and use a terminal besides cmd.exe since the default terminal application has known issues which affect its usability with Julia and other libuv-based cross-platform software.

Uninstallation is performed by using the Windows uninstaller (or deleting the extracted directory). The packages directory in %HOME%/.julia can be deleted if you would no longer like to retain the user installed packages. If you would also like to remove your preferences files, remove %HOME%/.juliarc.jl and %HOME%/.julia_history.

## macOS

On macOS, a Julia-<version>.dmg file is provided, which contains Julia-<version>.app. Installation is the same as any other Mac software. Drag the Julia-<version>.app to Applications Folder’s Shortcut. You can also run Julia from the disk image by opening the app. Julia runs on macOS 10.8 and later releases.

To start running Julia from the Terminal, you can add julia to the PATH. First, open up the Terminal and determine whether you are using zsh or bash as your Terminal shell.

If you are using zsh, type the following in the Terminal:

open -a TextEdit ~/.zshrc

If you are using bash, type the following in the Terminal:

open -a TextEdit ~/.bash_profile

The commands above should open up a shell profile page in a GUI text editor.
Now, for both zsh and bash users, you can add the following to the bottom of the profile page:

export PATH=“/Applications/Julia-.app/Contents/Resources/julia/bin:${PATH}” Remember to replace the version of Julia-<version>.app above with the version of your Julia app. Once that is done, you can close the shell profile page and quit Terminal. Now, just simply open Terminal again, type in julia in it, and it should run your version of Julia! You can uninstall Julia by deleting Julia.app and the packages directory in ~/.julia. Multiple Julia.app binaries can co-exist without interfering with each other. If you would also like to remove your preferences files, remove ~/.juliarc.jl and ~/.julia_history. ## Linux and FreeBSD It is strongly recommended that the official generic binaries from the downloads page be used to install Julia on Linux and FreeBSD. The generic Linux and FreeBSD binaries do not require any special installation steps, but you will need to ensure that your system can find the julia executable. First, download the .tar.gz file from the downloads page. You need to extract this file to a suitable location. To extract the file, you can use the following command: tar -xvzf julia-x.y.z-linux-x86_64.tar.gz This will extract the files to a folder named julia-x.y.z. We would refer this as <Julia directory>. To run Julia, you can do any of the following: • Create a symbolic link to julia inside a folder which is on your system PATH • Add Julia’s bin folder to your system PATH environment variable • Invoke the julia executable by using its full path, as in <Julia directory>/bin/julia To add Julia’s bin folder to PATH environment variable, you can edit the ~/.bash_profile or ~/.bashrc file. Open the file in your favourite editor and add a new line as follows: export PATH=“$PATH:/path/to//bin”

Apart from this, there are several ways through which you can change environment variable. You can follow this guide to find out a way convenient for you.

Julia installs all its files in a single directory. Deleting the directory where Julia was installed is sufficient. If you would also like to remove your packages, remove ~/.julia. The startup file is at ~/.juliarc.jl and the history at ~/.julia_history.

# Platform Specific Instructions for Unofficial Binaries

The following distribution-specific packages are community contributed. They may not use the right versions of Julia dependencies or include important patches that the official binaries ship with. In general, bug reports will only be accepted if they are reproducible on the official generic binaries on the downloads page.

## Chocolatey on Windows

If you use Chocolatey for package management, you can install the latest Julia release by executing the following one-liner, in either a powershell or command prompt:

choco install julia –confirm

Chocolatey automatically creates a shim for the Julia executable, so you simply type julia to run Julia in the terminal. When a new version is released simply execute choco upgrade julia --confirm. If you want to uninstall Julia run choco uninstall julia --confirm.

## HomeBrew on Mac

Julia can be installed using the Homebrew package manager as follows:

This automatically puts the binary into a directory in the user’s PATH, so you can simply type julia to run Julia in the terminal.

## Fedora/RHEL/CentOS/SL/OEL Linux

A Copr repository is provided for Fedora, RHEL, CentOS, Scientific Linux and Oracle Enterprise Linux systems to allow for automatic updating to the latest stable version of Julia.

If you are using RHEL, CentOS, Scientific Linux or Oracle Enterprise Linux (version 5 or higher), first enable EPEL for your distribution version. Then follow the steps below.

If you are using Fedora (version 19 or higher), directly run:

sudo dnf copr enable nalimilan/julia sudo yum install julia

If you are using CentOS (version 7 or higher), directly run:

sudo yum-config-manager –add-repo https://copr.fedorainfracloud.org/coprs/nalimilan/julia/repo/epel-7/nalimilan-julia-epel-7.repo sudo yum install julia

If both dnf and yum-config-manager are not available for your distribution, download the relevant .repo file from the Copr webpage, copy it to /etc/yum.repos, and run the second command.

Note that Fedora guidelines advise against uploading new breaking releases to official repositories: therefore your distribution will not provide the new major versions of Julia which were published after it. When reporting issues, please ensure you are using the latest available release by using one of the Copr repositories displayed on this page. In order to use nightly Julia builds, replace nalimilan/julia with nalimilan/julia-nightlies in the instructions above. These can then be updated with yum upgrade julia.

## Debian/Ubuntu Linux

Recent Debian/ubuntu distributions include their own build of Julia, which can be installed in the usual way. If this is not the version of Julia you want, you will need to use the official binaries.

sudo apt install julia

## FreeBSD Ports

Julia is available in the Ports Collection. To install from the FreeBSD binary package manager, pkg, run

pkg install julia