# Ngrok

## What is this?

Ngrok container is a thing that can save you a decent amount of time during the third-party integrations’ development process. Feel welcome to get acknowledged with the documentation [on the official website](https://ngrok.com/).

The `ngrok` container provides an opportunity to get your application tunnelled from your `localhost` to a remote `ngrok` domain, which is cost-free for up to 8 hours and is convenient to enter into any API that should whitelist you explicitly.

## Before you start

Make sure your Docker setup is relevant - it should have a `docker-compose.ngrok.yml` file provided. If you don’t see this file - try simply migrating this single file from the latest Docker setup version.

## It is time to setup!

The only thing necessary here is including the `docker-compose.ngrok.yml` file in your startup/teardown sequence.

### Linux

In order to launch the project with the ngrok container on Linux platform, you should add a new alias to your alias pool. See an example below.

```bash
# Having the following alias
alias dcf='docker-compose -f docker-compose.yml -f docker-compose.local.yml -f docker-compose.ssl.yml -f docker-compose.frontend.yml'

# Create a new one for startup with the ngrok container
alias dcn='dcf -f docker-compose.ngrok.yml'
```

### Mac

In order to launch the project with the ngrok container on Mac platform, you should modify the `mutagen.<...>.yml` file(s) which you use to start the application. See an example below.

```yaml
beforeCreate:
  - >
    <....>
    -f docker-compose.ngrok.yml
    up -d --force-recreate
afterCreate:
  - >
    <....>
    -f docker-compose.ngrok.yml
    logs -f app
afterTerminate:
  - >
    <....>
    -f docker-compose.ngrok.yml
    down
```

## Using the container

1. Start the application using the new alias (Linux) or the updated file (Mac)
2. Go to `localhost:4040`
3. Utilise the functionality! See the ngrok usage instructions either inside of that panel or on the official website


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scandipwa.gitbook.io/docs/containers-description/ngrok.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.