Search…
Onboarding guides
Here's a step-by-step guide to adopting ReleaseHub in your organization.
  1. 1.
    Create a ReleaseHub account
  2. 2.
    Upgrade to a paid plan
  3. 3.
    Integrate your cloud provider
  4. 4.
    Link a domain
  5. 5.
    Create a cluster
  6. 6.
    Connect your source control provider
  7. 7.
    Create your application

Create a ReleaseHub account

Visit app.releasehub.com and sign up using your GitHub, Bitbucket or GitLab account.
Take a look at our Create an Account documentation if you need more information about this step.

Upgrade to a paid plan

After signing up, you'll have access to a limited free account which you can use to explore ReleaseHub and see how it works. For production hosting and using your own cloud account, you'll need to sign up for a paid plan. Email us at [email protected] or contact us using the chat button on our website to arrange this.

Integrate your cloud provider

In Account Settings, navigate to Clusters and press Create New Cloud Provider Integration. Currently, we support AWS and GCP.
Create new cloud provider integration
When prompted to log in to your cloud provider, you should use an account with enough privileges to create and destroy clusters, manage permissions, manage DNS settings, and other provider-specific functionality that ReleaseHub will need to function.
Take a look at the following docs for more help with integrating your cloud provider:

If you don't already have a domain, you should purchase one through your cloud provider (e.g. Route 53 if you're using AWS).
It's also possible to use a domain purchased through a third-party provider such as GoDaddy (follow our external DNS guide), but it's easier if you use your cloud provider directly.
To link your domain to ReleaseHub, go to Settings -> Domains -> Create New Domain.
Enter your domain and take note of the name servers that ReleaseHub will display. If you're using a third-party domain provider, configure your domain to point to these name servers.
Finally, verify your domain by pressing the Verify button.

Create a cluster

Once you have a linked and verified domain, you can create your first cluster. Navigate to Settings -> Clusters and choose Create New Cluster under your cloud provider.
Create new cluster
For more help with this, see Create a cluster

Connect your source control provider

ReleaseHub will pull code from your source control provider (such as GitHub) to deploy your application. You integrated a source provider account when you signed up for ReleaseHub, but you can further configure your source control provider to give ReleaseHub access to the correct repositories and edit other settings, like whether ReleaseHub automatically comments on your pull requests.
To get started, navigate to the home screen of your ReleaseHub console, press Create App and then press Connect on the next screen.
Connect git provider
You'll be given the option to grant ReleaseHub access to all of your repositories or only specific repositories. Once you've created the connection, you'll be able to view your respositories when creating a new app from ReleaseHub and select the one that you want to deploy using ReleaseHub.

Create and deploy an application

To test that everything works, you can deploy one of our ready-to-go example applications.
Select an example application and fork it to your integrated source control account. Then press Create New App from your ReleaseHub dashboard and choose the repository you forked.
Create new app

Where next

Now you can configure and monitor your applications through your ReleaseHub dashboard. If necessary, you can still access your AWS account and Kubernetes cluster directly, but for most use cases, you can enjoy our simplified controls and sensible defaults.
To get the most out of ReleaseHub, you should
Copy link
On this page
Create a ReleaseHub account
Upgrade to a paid plan
Integrate your cloud provider
Link your domain
Create a cluster
Connect your source control provider
Create and deploy an application
Where next