github-desktop/docs/installation.md

# Installing GitHub Desktop

GitHub Desktop currently supports Windows 7 (or higher) and macOS 10.9 (or higher).

### macOS

Download the `GitHub Desktop.zip`, unpack the application and put it wherever you want.

### Windows

On Windows you have two options:

 - Download the `GitHubDesktopSetup.exe` and run it to install it for the current user.
 - Download the `GitHubDesktopSetup.msi` and run it to install a machine-wide version of GitHub Desktop - each logged-in user will then be able to run GitHub Desktop from the program at `%PROGRAMFILES(x86)\GitHub Desktop Installer\desktop.exe`.

## Data Directories

GitHub Desktop will create directories to manage the files and data it needs to function. If you manage a network of computers and want to install GitHub Desktop, here is more information about how things work.

### macOS
 - `~/Library/Application Support/GitHub Desktop/` - this directory contains user-specific data which the application requires to run, and is created on launch if it doesn't exist. Log files are also stored in this location.

### Windows

 - `%LOCALAPPDATA%\GitHubDesktop\` - contains the latest versions of the app, and some older versions if the user has updated from a previous version.
 - `%APPDATA%\GitHub Desktop\` - this directory contains user-specific data which the application requires to run, and is created on launch if it doesn't exist. Log files are also stored in this location.

## Log Files

GitHub Desktop will generate logs as part of its normal usage, to assist with troubleshooting. They are located in the data directory that GitHub Desktop uses (see above) under a `logs` subdirectory, organized by date using the format `YYYY-MM-DD.desktop.production.log`, where `YYYY-MM-DD` is the day the log was created.

## Installer Logs

Problems with installing or updating GitHub Desktop are tracked in a separate file which is managed by the updater frameworks used in the app.

### macOS

 - `~/Library/Caches/com.github.GitHubClient.ShipIt/ShipIt_stderr.log` - this file will contain details about why the installation or update failed - check the end of the file for recent activity.

### Windows

 - `%LOCALAPPDATA%\GitHubDesktop\SquirrelSetup.log` - this file will contain details about update attempts for GitHub Desktop after it's been successfully installed.
 - `%LOCALAPPDATA%\SquirrelSetup.log` - information about the initial installation may be found here. As this framework is used by different apps, it may also contain details about other apps. Ensure that you focus on mentions of `GitHubDesktop.exe` in the log.
writing some docs 2017-03-27 10:28:45 +00:00			`# Installing GitHub Desktop`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			`GitHub Desktop currently supports Windows 7 (or higher) and macOS 10.9 (or higher).`
writing some docs 2017-03-27 10:28:45 +00:00
			`### macOS`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			Download the `GitHub Desktop.zip`, unpack the application and put it wherever you want.
writing some docs 2017-03-27 10:28:45 +00:00
			`### Windows`

			`On Windows you have two options:`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			- Download the `GitHubDesktopSetup.exe` and run it to install it for the current user.
Fixed some grammar mistakes and typographical errors in the docs. 2019-09-26 19:52:04 +00:00			- Download the `GitHubDesktopSetup.msi` and run it to install a machine-wide version of GitHub Desktop - each logged-in user will then be able to run GitHub Desktop from the program at `%PROGRAMFILES(x86)\GitHub Desktop Installer\desktop.exe`.
writing some docs 2017-03-27 10:28:45 +00:00
			`## Data Directories`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			`GitHub Desktop will create directories to manage the files and data it needs to function. If you manage a network of computers and want to install GitHub Desktop, here is more information about how things work.`
writing some docs 2017-03-27 10:28:45 +00:00
			`### macOS`
Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			- `~/Library/Application Support/GitHub Desktop/` - this directory contains user-specific data which the application requires to run, and is created on launch if it doesn't exist. Log files are also stored in this location.
writing some docs 2017-03-27 10:28:45 +00:00
			`### Windows`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			- `%LOCALAPPDATA%\GitHubDesktop\` - contains the latest versions of the app, and some older versions if the user has updated from a previous version.
			- `%APPDATA%\GitHub Desktop\` - this directory contains user-specific data which the application requires to run, and is created on launch if it doesn't exist. Log files are also stored in this location.
writing some docs 2017-03-27 10:28:45 +00:00
			`## Log Files`

Revert "Run Prettier on All The Things" 2018-02-01 23:08:53 +00:00			GitHub Desktop will generate logs as part of its normal usage, to assist with troubleshooting. They are located in the data directory that GitHub Desktop uses (see above) under a `logs` subdirectory, organized by date using the format `YYYY-MM-DD.desktop.production.log`, where `YYYY-MM-DD` is the day the log was created.
add section about the installer log locations 2019-05-21 18:42:29 +00:00
			`## Installer Logs`

			`Problems with installing or updating GitHub Desktop are tracked in a separate file which is managed by the updater frameworks used in the app.`

			`### macOS`

			- `~/Library/Caches/com.github.GitHubClient.ShipIt/ShipIt_stderr.log` - this file will contain details about why the installation or update failed - check the end of the file for recent activity.

			`### Windows`

			- `%LOCALAPPDATA%\GitHubDesktop\SquirrelSetup.log` - this file will contain details about update attempts for GitHub Desktop after it's been successfully installed.
			- `%LOCALAPPDATA%\SquirrelSetup.log` - information about the initial installation may be found here. As this framework is used by different apps, it may also contain details about other apps. Ensure that you focus on mentions of `GitHubDesktop.exe` in the log.