Environment Troubleshooting

Environment Requirements

Incompatible Operating System

Incompatible operating system, the current OS is: {SYS_PLATFORM}, the required OS are: macOS, Linux or Windows.

Redefine does not support the machine's operating system. You can find the list of supported OS here: Supported Operating Systems

Package Version Unsupported

Package {name} version is {version} - the minimal supported version is {supported_version}

Redefine supports the package indicated in the above message only from the minimum written version. If it is possible, please upgrade the version to {} and above. Otherwise, please contact Redefine customer support.

CI Platform not Detected

CI Platform not detected! The supported CI platforms are: [...]

Redefine could not detect your CI platform. This could mean one of the following -

• Redefine was executed outside of a CI Platform - this is not currently supported

• Redefine did not have access to the CI Environment variables, see further details and solution in CI Environment Variables Missing

• Redefine was executed in an unsupported CI Platform. Check Supported Technologies for detailed list of supported CI Platforms.

If this is not one of the cases above, please contact us at [e-mail]

CI Environment Variables Missing

CI platform-specific environment variables are missing - Make sure to you are running Redefine in your CI platform and it has access to the CI's environment variables

Redefine relies on environment variables delivered from the CI platform. Depending on your CI architecture, this may not be automatically available, for example -

• Running docker container in your CI - you will have to pass the environment variables from your CI platform to your docker image - see

• Running redefine in a process with clean environment variables - make sure to pass the parent's environment variables to the process running redefine"

Please make sure your CI is supported Supported Technologies

Package is not Officially Supported

Package {plugin} is not officially supported

Currently, the package is not officially supported or tested in Redefine. It is not expected to cause issues, but we recommend being aware of it and contacting us at [e-mail] in case of any problem.

Stable Branch Not Configured

Stable branch is not configured, can't verify git - Make sure to configure stable branch using Redefine config set stable_branch=<your_branch>

You did not configure your Redefine stable branch, please make sure to configure it by running Redefine config set stable_branch=<your_stable_branch> For more information see

Can't Detect Branch From CI

Can't detect branch from CI environment variables, cannot verify git!

Redefine relies on environment variables delivered from the CI platform. Depending on your CI architecture, this may not be automatically available, for example -

• Running docker container in your CI - You will have to propagate the environment variables from your CI platform to your docker image - See docker run with env.

• Running redefine in a process with clean environment variables - Make sure to pass the parent's environment variables to the process running redefine

Please make sure your CI is supported Supported Technologies

Missing CI Parameter

{param} (env name: {env}): Missing!

A param named {param_name} is missing and could not be auto-detected. for example: source_branch, source_commit, git_repo, job_name, pipeline_name, ci_run_id. make sure you are running on a valid CI platform.

Redefine Authorization

Redefine Key Missing

REDEFINE_AUTH environment variable not set - Make sure to export it correctly, Make sure to set it with the API_KEY you were provided by Redefine.dev If you haven't, please contact us at [e-mail]

Redefine requires a REDEFINE_AUTH env to be exported for authentication.

• The required format for the variable is: <client_id>::<client_secret>

• for secrets storing best practices see GitHub Actions | GitLab CI | Jenkins | CircleCI | TeamCity

• If you haven’t received Redefine credentials, contact us at https://www.redefine.dev/demo.

Authorization Variable Improperly Formatted

REDEFINE_AUTH environment variable is not in the format client_id::client_secret

Redefine requires a REDEFINE_AUTH env to be exported with the format: <client_id>::<client_secret>, please make sure to export it in the correct format, or contact support if you don't know what is your Redefine auth

Failed to Authenticate

Failed to generate authentication token, please contact Redefine support at [e-mail]

If Redefine fails to authenticate for an unknown reason, contact Redefine support

Server Connection Issues

Unable to connet to Redefine Server

Unable to connect to Redefine server - Make sure you have access to Redefine.dev and its sub-domains, and outgoing rule for port 443/50500

Redefine uses ports 443/50500 to perform gRPC access to the Redefine Cloud. If this access is blocked, Redefine will not be able to operate. Please make sure the access isn't blocked by a firewall or other means.