GitPitch Desktop Launch


Interested in taking GitPitch Desktop for a test drive? To start your 7 day free trial and see one-time purchase and subscription pricing options visit the GitPitch website here .

The Desktop launch instructions in this guide assume you have completed the following:

  1. You have activated a GitPitch Paid Plan .
  2. You have installed Docker Desktop .
  3. You have downloaded + installed GitPitch Desktop .

Having these prerequisites in place you have two launch options:

  1. Launch using Docker Run
  2. Launch using Docker Compose

Launch using Docker Run

When you launch the Desktop using the docker run command you need to indicate a local working directory where your presentation files (markdown, images, etc) can be found. The Desktop then monitors this directory on your local file system for changes. When file changes are detected the desktop will automatically update the live preview of your slide deck in the browser.

Typically this directory is a local Git repository. Although it can be any directory on the local file system.

The default launch command for the Desktop is as follows:

docker run -it -v {WORKINGDIR}:/repo -p 9000:9000 gitpitch/desktop:pro

Note, {WORKINGDIR} is a placeholder. You must replace it with an absolute path to a working directory on your local file system where your presentation files are found.

For example, here is a sample launch command on MacOS:

docker run -it -v /Users/david/test:/repo -p 9000:9000 gitpitch/desktop:pro

And here is a sample launch command on Windows:

docker run -it -v c:/david/test:/repo -p 9000:9000 gitpitch/desktop:pro

Upon successful launch you should be able to access the Desktop in your browser at the following URL:

http://localhost:9000

To open your browser at the default Desktop URL, click here .

Launch using Docker Compose

You can use the docker-compose command as a convenient alternative to docker run . To use Compose you first need to copy and save the following service description into a file on your local disk:

version: '3'
services:
  gitpitch:
    image: gitpitch/desktop:pro
    volumes:
      - .:/repo
    ports:
      - "9000:9000"
    environment:
      - PORT=9000

Following Docker conventions, we recommend saving this service description into a file called docker-compose.yaml.

Now to launch the Desktop copy this file into the local working directory where your presentation files (markdown, images, etc) can be found. Then within that directory, use the following launch command:

docker-compose up

Upon successful launch you should be able to access the Desktop in your browser at the following URL:

http://localhost:9000

To open your browser at the default Desktop URL, click here .

Tip! Using Docker Compose Custom YAML Naming

As noted above the Docker Compose convention looks for a file named docker-compose.yaml to start a container service. If you prefer to use a custom file name when launching the Desktop you can do so.

For example, if you copied and saved the Desktop service description into a file called gitpitch-launch.yaml you would use it as follows:

docker-compose -f gitpitch-launch.yaml up