> For the complete documentation index, see [llms.txt](https://docs.diffy.website/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diffy.website/features/local-development/ngrok.md).

# Ngrok

You can test your local site by tunneling with ngrok so Diffy has access to it.

### Set up ngrok

If you like, I can share with you Diffy's account for testing purposes. Once it works, you can purchase your Personal license yourself.

1. Create an account at <https://ngrok.com/> and purchase the license
2. Install ngrok locally (for Mac, it is simple `brew install ngrok`)
3. Populate auth code locally `ngrok config add-authtoken <your token>`

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2F2wFBJyNJ1VPOk8q8zRQX%2Fconfigure-ngrok-screenshot.png?alt=media&amp;token=c28316b9-7e48-4b82-8aa0-fcdf5b7b3814" alt=""><figcaption><p>set up ngrok</p></figcaption></figure>

### DDEV setup

Now, you can expose your local site globally by running `ddev share`

For other environments, please check the documentation. Here is an article for [Lando](https://hackernoon.com/lando-wordpress-and-ngrokoh-my). For Docksal similar command `fin share` ([documentation](https://docs.docksal.io/tools/ngrok/)).

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2F82t3LL2w0xR3sSvsW04U%2Fngrok-ddev-share-screenshot.png?alt=media&amp;token=e8b9b57c-3e7d-46cb-9372-d5b6132b9425" alt=""><figcaption><p>ddev share</p></figcaption></figure>

Remember to copy the URL from ngrok.

### Create custom screenshot with Diffy

Now, you can create screenshots from a custom environment. Specify the URL you got from ngrok.

***Important notice**: We can easily overload your local environment if you set the number of non-production workers to 5.*

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2F71faSCWl9EJ4VoscC7vF%2Fimage.png?alt=media&amp;token=ce8dd289-8a56-4dc9-a95c-53b01dea0a52" alt=""><figcaption><p>custom screenshots from ngrok environment</p></figcaption></figure>
