Git Repo Services

By default, the GitPitch server hosted on GitPitch.com is configured to communicate with the following GRS (Git Repository Services):

• GitHub.com
• GitLab.com
• Bitbucket.org

To switch between these GRS services on GitPitch simply use the built-in switching menu found in the bottom-left corner of every slideshow presentation page:

As soon as you make a GRS selection in this menu your GitPitch slideshow presentation page will automatically start communicating with the chosen GRS.

Git Repository Service Configuration

If you host your own GitPitch server you can customize the GRS configuration to suit your particular needs. The conf/application.conf file is used to configure key meta-data identifying each active Git repository service on a GitPitch server. The default configuration on GitPitch.com looks as follows:

gitpitch {
  git {
    repo {
        services = [

            {
                name        = "GitHub"
                type        = "github"
                site        = "https://github.com/"
                apibase     = "https://api.github.com/"
                // apitoken    = "token your-github-access-token-here"
                apitokenheader    = "Authorization"
                rawbase     = "https://raw.githubusercontent.com/"
                default     = "true"
            }
            {
                name        = "GitLab"
                type        = "gitlab"
                site        = "https://gitlab.com/"
                apibase     = "https://gitlab.com/api/v3/"
                // apitoken    = "your-gitlab-access-token-here"
                apitokenheader    = "PRIVATE-TOKEN"
                rawbase     = "https://gitlab.com/"
                default     = "false"
            }
            {
                name        = "Bitbucket"
                type        = "bitbucket"
                site        = "https://bitbucket.org/"
                apibase     = "https://api.bitbucket.org/2.0/"
                // apitoken    = "your-bitbucket-access-token-here"
                apitokenheader    = "Authorization"
                rawbase     = "https://bitbucket.org/"
                default     = "false"
            }

        ]
    }
  }
}

Please note the following:

1. The apitoken for each GRS property is commented out in the configuration snippet above. If you launch your own GitPitch server instance make sure you add your private authentication tokens for each GRS as appropriate.

2. You can use custom configuration for these GRS services if you want to direct your own GitPitch server instance to communicate with GRS hosted at custom URLs, for example, with a private GitLab server.

3. Your custom configuration must specify at least one GRS service.

4. The configuration snippet above indicates GitHub as the default GRS service on GitPitch.com. If you launch your own GitPitch server instance you can set your own default GRS as appropriate.