Nim/web/download.rst

Download the compiler
=====================

You can download the latest version of the Nim compiler here.

Windows
-------

Zips
%%%%

Since the website moved to https, only installation via the provided zipfiles
is supported:

* | 32 bit: `nim-0.16.0_x32.zip <download/nim-0.16.0_x32.zip>`_
  | SHA-256  69af94a6875a02543c1bf0fa03c665f126f8500a2c0e226c32571e64c6842e57
* | 64 bit: `nim-0.16.0_x64.zip <download/nim-0.16.0_x64.zip>`_
  | SHA-256  e667cdad1ae8e9429147aea5031fa8a80c4ccef6d274cec0e9480252d9c3168c

Unzip these where you want and **optionally** run ``finish.exe`` to
detect your MingW environment. (Though that's not reliable yet.)

You can find the required DLLs here, if you lack them for some reason:

* | 32 and 64 bit: `DLLs.zip <download/dlls.zip>`_
  | SHA-256  198112d3d6dc74d7964ba452158d44bfa57adef4dc47be8c39903f2a24e4a555


These versions of mingw are known to work:

* | 32 bit: `mingw32-6.3.0 <download/mingw32-6.3.0.7z>`_
  | SHA-256  1239a56d4c42e146b2cb25dc4d0871bd83f569d0a51a9198e84d010e0a75745a
* | 64 bit: `mingw64-6.3.0 <download/mingw64-6.3.0.7z>`_
  | SHA-256  9a23d12d96a10e67093c1f2042275c6a7d29da9e2ead573d0f24f4a6d53761a1



Installation based on generated C code
--------------------------------------

**Note:** The Nim compiler requires a C compiler to compile software. On
Windows we recommend that you use
`Mingw-w64 <http://mingw-w64.sourceforge.net/>`_. GCC is recommended on Linux
and Clang on Mac. The Windows installers above already includes a C compiler.

This installation method is the preferred way for Linux, Mac OS X, and other Unix
like systems.

Firstly, download this archive:

* | `nim-0.16.0.tar.xz (2.9MB) <download/nim-0.16.0.tar.xz>`_
  | SHA-256  9e199823be47cba55e62dd6982f02cf0aad732f369799fec42a4d8c2265c5167

Extract the archive. Then copy the extracted files into your chosen installation
directory, ideally somewhere in your home directory.
For example: ``~/programs/nim``.

Now open a terminal and follow these instructions:

* ``cd`` into your installation directory, for example by executing
``cd ~/programs/nim``.
* run ``sh build.sh``.
* Add ``$your_install_dir/bin`` to your PATH.
* To build associated tools like ``nimble`` and ``nimsuggest`` run ``nim c koch && ./koch tools``.

After restarting your terminal, you should be able to run ``nim -v``
which should show you the version of Nim you just installed.

There are other ways to install Nim (like using the ``install.sh`` script),
but these tend to cause more problems.


Bleeding edge installation from GitHub
--------------------------------------

`GitHub <http://github.com/nim-lang/nim>`_ is where Nim's development takes
place. You may wish to grab the latest development version of Nim, because
sometimes bug fixes and new features may not have made it to an official
release yet. In those circumstances you are better off grabbing the
current development branch.

You will also need to do this if you would like to contribute to Nim.

Before you download the code, open a new terminal and ``cd`` into the
directory where you would like the download to take place.

The following commands can be used to download the current development branch
and then to build it::

  git clone https://github.com/nim-lang/Nim.git
  cd Nim
  git clone --depth 1 https://github.com/nim-lang/csources
  cd csources && sh build.sh
  cd ..
  bin/nim c koch
  ./koch boot -d:release

You should then add the ``./bin`` (make sure to expand this into an
absolute path) directory to your ``PATH``.


Docker Hub
----------

The `official Docker images <https://hub.docker.com/r/nimlang/nim/>`_
are published on Docker Hub and include the compiler and Nimble. There are images
for standalone scripts as well as Nimble packages.

Get the latest stable image::

  docker pull nimlang/nim

The latest development version::

  docker pull nimlang/nim:devel