Allow Tart to search for Softnet installed via Homebrew

[jadar]

I am trying to configure Tart to use softnet with the gitlab-tart-executor. It seems that it tries to run Tart with softnet enabled, but the logs show that it cannot find the softnet executable on the PATH. GitLab Runner makes it a real pain to change the PATH, having to manually edit the LaunchAgent. This works, but only until the next time you run gitlab-runner install. It would be nice if Tart could look for Softnet in the /opt/homebrew/bin directory before failing. The gitlab-tart-executor service already does this for tart, so it should be okay for Tart to do this too?

concurrent = 2
check_interval = 0
shutdown_timeout = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "mobiledevops_2"
  url = "<redacted>"
  id = 13584
  token = "<redacted>"
  token_obtained_at = 2025-11-18T17:22:29Z
  token_expires_at = 0001-01-01T00:00:00Z
  executor = "custom"
  environment = ["TART_EXECUTOR_SOFTNET=true"]
  [runners.feature_flags]
    FF_RESOLVE_FULL_TLS_CHAIN = false
  [runners.custom]
    config_exec = "/opt/homebrew/bin/gitlab-tart-executor"
    config_args = ["config", "--cache-dir", "/Users/administrator/.gitlab-runner/cache"]
    prepare_exec = "/opt/homebrew/bin/gitlab-tart-executor"
    prepare_args = ["prepare", "--concurrency", "2", "--cpu", "auto", "--memory", "auto"]
    run_exec = "/opt/homebrew/bin/gitlab-tart-executor"
    run_args = ["run"]
    cleanup_exec = "/opt/homebrew/bin/gitlab-tart-executor"
    cleanup_args = ["cleanup"]

[edigaryev]

It would be nice if Tart could look for Softnet in the /opt/homebrew/bin directory before failing.

Besides being a questionable practice, there are cases when it's desirable to fully control the PATH, for example, when developing and testing Tart and Softnet.

What we can do instead it to provide an additional command-line argument like --tart-run-env to prepare stage of the GitLab Tart Executor.

This way you'll be able to add a PATH environment variable override to you GitLab Runner configuration, and tart run will see it.

Would that work for you?

[jadar]

That would work

[edigaryev]

Please check out the latest 1.27.0 release, it should now support --tart-run-env command-line argument to prepare stage.

[jadar]

Thank you!