Skip to main content
Version: 3.x

Exposing local instance

There are situations when you would like to expose your local environment to external clients, for example:

  • Show your project to the manager.
  • Integrate with the new payment gateway, which requires a return URL.
  • Test the app deployed in the cloud.

To achieve that, you need a service for redirecting the traffic. Such service is delivered by ngrok and localtunnel. Both are great for our use case, and you can choose any of those services.

Using ngrok

  1. Append ngrok URL to ALLOWED_CLIENT_HOSTS environment variable.
  2. Start Saleor on your machine.
  3. Follow ngrok installation guide.
  4. Start a tunnel in your command line ngrok http 8000.
  5. Your server is now exposed under ngrok domain (for example: http://92832de0.ngrok.io). Copy that address.
  6. Enter ngrok URL at Site Settings configuration.

Was this page helpful?