<type>documentation</type>
<domain>intro</domain>
<id>installing</id>
<title>Installing Wing</title>
<date>$Date$</date>
<version>$Revision$</version>
<product>all</product>

Before installing Wing, be sure that you have installed the `necessary
prerequisites`__.
If you are upgrading from a previous version, see `Upgrading`__ first.

__ ref:install/prerequisites
__ ref:install/upgrading

**Note:** The installation location for Wing is referred to as ``WINGHOME``.
On macOS this is the name of Wing's ``.app`` folder.

**Windows**

Install Wing by running the downloaded executable. Wing's files are
installed by default in ``C:\Program Files (x86)\~~PRODUCT_NAME~~ 
~~MAJOR_VERSION~~``, but this location may be modified 
during installation. Wing will also create a `Settings Directory`__
in the location appropriate for your version of Windows. This is used to
store preferences and other settings.

__ ref:install/user-settings-dir

The Windows installer supports a ``/silent`` command line option that uses 
the default options, including removing any prior install of 
Wing ~~MAJOR_VERSION~~.  If a prior install is 
removed, a dialog with a progress bar will appear.  You can also use a 
``/dir=<dir name>`` option to specify an alternate installation directory. 

The ``/verysilent`` command line option has the same effect as ``/silent`` but also
prevents display of a progress bar.

~~~if WEBSITE:
For Wing Personal the default install directory is instead named 
``Wing Personal ~~MAJOR_VERSION~~`` and for Wing 101 it is 
named ``Wing 101 ~~MAJOR_VERSION~~``.
~~~

**Linux**

Use the RPM, Debian package, or tar file installer as appropriate for your
system type. Installation from packages is at
``/usr/lib/~~PRODUCT_SPEC_VERSION~~`` or at the
selected location when installing from the tar file. Wing will also create a
`Settings Directory <ref:install/user-settings-dir>`__ in ``~~POSIX_USER_DIR~~``, which 
is used to store preferences and other settings.

For more information, see the `Linux installation details`__.

__ ref:install/linux-installation-detail

~~~if WEBSITE:
For Wing Personal the install directory is instead named 
``wing-personal6`` and for Wing 101 it is named ``wing-101-6``.
~~~

**macOS**

On macOS, Wing is installed simply by opening the distributed disk image and dragging
to the Applications folder, and optionally from there to the task bar.
