Sha256: 129105ae9ae77e50e65cd7a893855f675a3d9d73b56d4b2d55eacd811b64df8f

Contents?: true

Size: 1.23 KB

Versions: 97

Compression:

Stored size: 1.23 KB

Contents

# HTTP Tunneling with ngrok

Before your application can take advantage of features that depend on incoming webhooks, you'll need to setup an HTTP tunnel using a service like [ngrok](https://ngrok.com).

## Use a Paid Plan

You should specifically sign up for a paid account. Although ngrok offers a free plan, their $8/year or $10/month [paid plan](https://ngrok.com/pricing) will allow you to reserve a custom subdomain for reuse each time you spin up your tunnel. This is a critical productivity improvement, because in practice you'll end up configuring your tunnel URL in a bunch of different places like `config/application.yml` but also in external systems like when you [configure payment providers to deliver webhooks to you](/docs/billing/stripe.md).

## Usage

Once you have ngrok installed, you can start your tunnel like so, replacing `YOUR-SUBDOMAIN` with whatever subdomain you reserved in your ngrok account:

```
ngrok http --domain=YOUR-SUBDOMAIN 3000
```

## Updating Your Configuration

Before your Rails application will accept connections on your tunnel hostname, you need to update `config/application.yml` with:

```yaml
BASE_URL: https://YOUR-SUBDOMAIN.ngrok.io
```

You'll also need to restart your Rails server:

```
rails restart
```

Version data entries

97 entries across 97 versions & 1 rubygems

Version Path
bullet_train-1.14.0 docs/tunneling.md
bullet_train-1.13.0 docs/tunneling.md
bullet_train-1.12.3 docs/tunneling.md
bullet_train-1.12.2 docs/tunneling.md
bullet_train-1.12.1 docs/tunneling.md
bullet_train-1.12.0 docs/tunneling.md
bullet_train-1.11.0 docs/tunneling.md
bullet_train-1.10.0 docs/tunneling.md
bullet_train-1.9.0 docs/tunneling.md
bullet_train-1.8.5 docs/tunneling.md
bullet_train-1.8.4 docs/tunneling.md
bullet_train-1.8.3 docs/tunneling.md
bullet_train-1.8.2 docs/tunneling.md
bullet_train-1.8.1 docs/tunneling.md
bullet_train-1.8.0 docs/tunneling.md
bullet_train-1.7.23 docs/tunneling.md
bullet_train-1.7.22 docs/tunneling.md
bullet_train-1.7.21 docs/tunneling.md
bullet_train-1.7.20 docs/tunneling.md
bullet_train-1.7.19 docs/tunneling.md