Custom local endpoint
2 minute read
You can configure the local endpoint URL under which LocalStack is accessible from the LocalStack Web UI. To configure your local endpoint URL, navigate to your Account settings, to configure the local endpoint URL (defaults to https://localhost.localstack.cloud). Additionally, you can configure the local endpoint URL to view your resources if you are running LocalStack on a different machine (see instructions below).
Connecting to a LocalStack instance on a different machine
To ensure that the Web user interface can connect with your running LocalStack instance, you would need to configure the endpoint URL so that the server’s SSL certificate matches the hostname/IP address of the endpoint URL. This situation arises when users configure the endpoint URL to be something like
https://myhost:4566 or use an IP address like
https://188.8.131.52:4566. Websites with an
https://... URL can only request other endpoints using HTTPS (i.e., not on
http://). Additionally, while requesting an HTTPS page, the SSL certificate must match the hostname (i.e.,
localhost.localstack.cloud in our case).
To navigate this, we recommend you create a local TCP proxy server. The proxy server could listen on
127.0.0.1:4566 and forward all requests to your target endpoint where the LocalStack instance is running. You could leave the configuration in the Web user interface to use the default value,
https://localhost.localstack.cloud:4566. We recommend simpleproxy or proxy.py as a way to implement this.
An alternate workaround would be to re-point
localhost.localstack.cloud to the IP address of your target machine by adding an entry to
/etc/hosts. This is especially useful if you’re accessing the LocalStack Web UI on a macOS/Linux-based machine.