.. _installation:

Installation guide
==================

The preferred way of installing Hare is using your local system package
manager. The recommended package name is "hare". If Hare is not available for
your distribution, continue to :ref:`bootstrap`.

.. note::
   Once you have installed Hare, check out the
   `General language introduction <https://harelang.org/tutorials/introduction>`_
   next.

.. note::
   All Hare users are encouraged to subscribe to the low-volume `hare-announce`_
   mailing list to be notified of new releases, breaking changes, and security
   updates.

.. _hare-announce: https://lists.sr.ht/~sircmpwn/hare-announce

.. toctree::
   :maxdepth: 1
   :caption: Contents

   bootstrap
   editors
   packaging

Supported platforms
-------------------

Hare is supported on the following platforms:

Architectures
~~~~~~~~~~~~~

============ ==============
Architecture Support status
============ ==============
aarch64      ✓ Supported
riscv64      ✓ Supported
x86_64       ✓ Supported
armv6        … Planned
i686         … Planned
ppc64        … Planned
riscv32      … Planned
============ ==============

Operating Systems
~~~~~~~~~~~~~~~~~

================ ==============
Operating system Support status
================ ==============
Linux            ✓ Supported
FreeBSD          ✓ Supported
OpenBSD          ✓ Supported
NetBSD           … Planned
Illumos          … Planned
Haiku            … Planned
Plan 9           … Planned
================ ==============

See also: :ref:`win-macos`