Adopt official ngrok image in Docker compose

[bschaatsbergen]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request. Searching for pre-existing feature requests helps us consolidate datapoints for identical requirements into a single place, thank you!
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

---

Overview of the Issue

The Docker compose currently uses an unofficial ngrok Docker image, by wernight — which hasn't been updated in a while and doesn't have proper arm/v8 support. A fix would be to simply replace the wernight/ngrok image with ngrok/ngrok.

Reproduction Steps

On MacOs Sequoia 15.5 (Apple Silicon) docker-compose up --detach fails with the below logs:

Logs

~/github/bschaatsbergen/atlantis> docker-compose up --detach
[+] Running 1/1
 ✔ ngrok Pulled                                                                                                                                                                                           1.1s
[+] Running 5/5
 ✔ Network atlantis_default                                                                                                                             Created                                           0.0s
 ✔ Container atlantis-redis-1                                                                                                                           Started                                           0.3s
 ✔ Container atlantis-atlantis-1                                                                                                                        Started                                           0.4s
 ✔ Container atlantis-ngrok-1                                                                                                                           Started                                           0.4s
 ! ngrok The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested

And when running docker-compose logs --follow you can see the issue:

atlantis-1  | No files found in /docker-entrypoint.d/, skipping
atlantis-1  | {"level":"info","ts":"2025-07-27T20:58:02.412Z","caller":"server/server.go:342","msg":"Supported VCS Hosts: Github","json":{}}
atlantis-1  | {"level":"info","ts":"2025-07-27T20:58:02.710Z","caller":"server/server.go:503","msg":"Utilizing BoltDB","json":{}}
atlantis-1  | {"level":"info","ts":"2025-07-27T20:58:02.722Z","caller":"policy/conftest_client.go:168","msg":"failed to get default conftest version. Will attempt request scoped lazy loads DEFAULT_CONFTEST_VERSION not set","json":{}}
atlantis-1  | {"level":"info","ts":"2025-07-27T20:58:02.727Z","caller":"server/server.go:1120","msg":"Atlantis started - listening on port 4141","json":{}}
atlantis-1  | {"level":"info","ts":"2025-07-27T20:58:02.728Z","caller":"scheduled/executor_service.go:51","msg":"Scheduled Executor Service started","json":{}}
ngrok-1     | http - start an HTTP tunnel
ngrok-1     |
ngrok-1     | USAGE:
ngrok-1     |   ngrok http [address:port | port] [flags]
ngrok-1     |
ngrok-1     | AUTHOR:
ngrok-1     |   ngrok - <support@ngrok.com>
ngrok-1     |
ngrok-1     | COMMANDS:
ngrok-1     |   config          update or migrate ngrok's configuration file
ngrok-1     |   http            start an HTTP tunnel
ngrok-1     |   tcp             start a TCP tunnel
ngrok-1     |   tunnel          start a tunnel for use with a tunnel-group backen
ngrok-1     |
ngrok-1     | EXAMPLES:
ngrok-1     |   ngrok http 80                                                 # secure public URL for port 80 web server
ngrok-1     |   ngrok http --domain baz.ngrok.dev 8080                        # port 8080 available at baz.ngrok.dev
ngrok-1     |   ngrok tcp 22                                                  # tunnel arbitrary TCP traffic to port 22
ngrok-1     |   ngrok http 80 --oauth=google --oauth-allow-email=foo@foo.com  # secure your app with oauth
ngrok-1     |
ngrok-1     | Paid Features:
ngrok-1     |   ngrok http 80 --domain mydomain.com                           # run ngrok with your own custom domain
ngrok-1     |   ngrok http 80 --allow-cidr 1234:8c00::b12c:88ee:fe69:1234/32  # run ngrok with IP policy restrictions
ngrok-1     |   Upgrade your account at https://dashboard.ngrok.com/billing/subscription to access paid features
ngrok-1     |
ngrok-1     | Upgrade your account at https://dashboard.ngrok.com/billing/subscription to access paid features
ngrok-1     |
ngrok-1     | Flags:
ngrok-1     |   -h, --help      help for ngrok
ngrok-1     |
ngrok-1     | Use "ngrok [command] --help" for more information about a command.
ngrok-1     |
ngrok-1     | ERROR:  authentication failed: Your ngrok-agent version "3.6.0" is too old. The minimum supported agent version for your account is "3.7.0". Please update to a newer version with `ngrok update`, by downloading from https://ngrok.com/download, or by updating your SDK version. Paid accounts are currently excluded from minimum agent version requirements. To begin handling traffic immediately without updating your agent, upgrade to a paid plan: https://dashboard.ngrok.com/billing/subscription.
ngrok-1     | ERROR:
ngrok-1     | ERROR:  ERR_NGROK_121
ngrok-1     | ERROR:
q^C

[dosubot]

Hi @bschaatsbergen! I'm Dosu and I’m helping the atlantis team.

The current Docker Compose setup for Atlantis uses the unofficial wernight/ngrok image, which is configured with environment variables like NGROK_PROTOCOL and NGROK_PORT, and depends on the atlantis service. There is no documentation or discussion in the Atlantis repo about adopting the official ngrok/ngrok image or its configuration.

To migrate, you'll need to consult the official ngrok Docker image documentation, as its environment variables and entrypoint may differ from the unofficial image. Start by swapping the image in your Docker Compose file and adjust the configuration as needed based on the official image's requirements and observed behavior. Document any migration steps or caveats for future contributors, since this info is currently missing from the repo.

For reference, the current configuration is in the docker-compose.yml.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}