Gateways

1. Navigate to the Gateways tab in an Ignite deployment:

2. Click on the “Create Gateway” button in the top right:

3. You will be presented with a modal:

Here, you can select the gateway type and target port.

Gateway type can be either:

• External, or
• Internal

At the moment, external gateways only support HTTP(S), so there’s no option to select the protocol yet.

The target port should be the port your app listens on. The gateway will load balance requests between containers on the target port. HTTP gateways will automatically handle external HTTP and HTTPS termination on the correct ports (80 & 443), so you don’t need to run your application on these ports.

4. Click Create Gateway.

To create a gateway interactively, run the following command:

hop gateways create [--project <project-namespace>]

This will take you through the steps to set up a gateway on a deployment.

You can also create a gateway non-interactively by passing the following flags:

hop gateways create \
  --type <type> \
  --target-port <port> \
  --project [namespace]

1. Head over to the “Domains” page inside your gateway.

2. Here, you can manage the .hop.sh domain as well as add your own custom ones. To add a custom domain, click on the Attach Domain button in the top right of the page.

3. You will be presented with this modal, where you should enter your desired domain.

4. Click Next.

After this, you will be required to create a CNAME record for your previously entered domain pointing to Hop.

5. Details about this record will be shown on screen in a modal after entering the domain. You should add this record to your DNS provider.