diff --git a/docs/_images/gitpitch-desktop-docker-dashboard.png b/docs/_images/gitpitch-desktop-docker-dashboard.png new file mode 100644 index 0000000..0472b6b Binary files /dev/null and b/docs/_images/gitpitch-desktop-docker-dashboard.png differ diff --git a/docs/desktop/launch.md b/docs/desktop/launch.md index 1ac17a8..54450f8 100644 --- a/docs/desktop/launch.md +++ b/docs/desktop/launch.md @@ -4,14 +4,39 @@ This guide assumes that you have successfully [downloaded the desktop app](/desktop/download.md). The following desktop app launch options are available: +- [Use the Docker Dashboard](#use-the-docker-dashboard) - [Use a Bash Alias](#use-a-bash-alias) - [Use Docker Run](#use-docker-run) - [Use Docker Compose](#use-docker-compose) - [Windows Launch Tips](#windows-launch-tips) +### Use the Docker Dashboard + +?> To use the Docker Dashboard you must install or update to Docker Desktop 2.2 or later. You can download the latest release of Docker Desktop [here](https://www.docker.com/products/docker-desktop). + +The Docker Dashboard provides an intuitive UI that you can use to manage and launch GitPitch Desktop. This is the recommended approach to launch GitPitch Desktop. If you are prefer to work with a CLI rather than a UI see the other launch options details in this guide. + +The following short video introduces Docker Dashboard and demonstrates how it can be used to quickly launch GitPitch Desktop: + + + +The video details and demonstrates the steps to launch GitPitch Desktop. The following screenshot is also provided as a quick reference for the main settings described in the video: + +![Screenshot showing the Docker Desktop Dashboard](../_images/gitpitch-desktop-docker-dashboard.png) + +These settings are summarized again here for your convenience: + +1. The **Container Name** describes the purpose of a collection of slide decks in a specific directory. +1. The **Local Host** must always be set to **9000**. +1. The **Host Path** points to a local file system directory that contains your presentation files. +1. The **Container Path** must always be set to **/repo**. +1. After specifying custom values for these settings, click **Run**. + +As noted in the video you can define and name multiple container instances for GitPitch Desktop. You can then switch between these instances to launch GitPitch Desktop for different collections of slide decks on your file system. + ### Use a Bash Alias -By far the simplest way to launch the desktop app is to create a simple *bash alias* or equivalent for your preferred shell. +The simplest way to launch the desktop app using the command line is to create a simple *bash alias* or equivalent for your preferred shell.