Troubleshoot common installation issues in Cloud Code for IntelliJ
Stay organized with collections
Save and categorize content based on your preferences.
How do I fix 'executable not found on PATH' errors?
If, during deployment or continuous development, you are getting errors in the
form of executable file not found in $PATH.
For example:
time="2018-11-01T12:46:38-04:00" level=fatal msg="exiting dev mode because the first build failed: building [gcr.io//my-proj]: tagging: pushing: getting auth config for gcr.io//my-proj:3c275201-dirty-50f870d: getting auth config: error getting credentials - err: exec: "docker-credential-gcr": executable file not found in $PATH, out: ``"
Then, you may be running into the problem where the IDE is not inheriting the
shell environment variables. This can happen in some Linux environments when
the PATH variables are defined in .bash_profile or .bash_rc and the
IDE is launched from the GUI, causing the IDE not to see the PATH variables.
This can be solved by allowing Cloud Code to automatically manage
updates to gcloud CLI and Kubernetes dependencies, using the Cloud Code
settings within your IDE (File > Settings > Tools > Cloud Code >
Kubernetes or for Mac OS X, IntelliJ IDEA >
Preferences > Tools > Cloud Code > Kubernetes).
If you'd like to maintain custom versions of these dependencies, you can
solve this issue in Linux using the following workaround:
Launch the IDE from the terminal
First, follow these instructions to enable a command-line launcher. Then
launch the IDE from the terminal.
For example, to launch IntelliJ IDEA from the terminal, navigate to
the project you wish to open, then execute:
idea .
Similarly, to launch PyCharm, execute:
charm .
Alternatively, set the PATH variables in a system-wide location such
as /etc/environment.
Diagnosing and reporting an issue
If your issue isn't covered in this doc, try finding a resolution to the issue
by:
Joining the #cloud-code
channel, which is part of the Google Cloud Slack community,
and asking about the issue, where one of the community members may be able to
identify the problem
If you couldn't resolve the issue after trying to diagnose it, then you can
report the issue in the IntelliJ IDE:
Click Tools > Cloud Code > Help / About > Submit feedback or
report an issue. This prompts you to report an issue on GitHub.
Follow the template in the issue reporting box to describe the issue.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe "executable file not found in $PATH" error often occurs when an IDE launched from a GUI doesn't inherit shell environment variables.\u003c/p\u003e\n"],["\u003cp\u003eThis issue can be resolved by letting Cloud Code automatically manage updates to gcloud CLI and Kubernetes dependencies within the IDE settings.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, launching the IDE from the terminal using its command-line launcher can resolve the issue by ensuring the IDE uses the current environment variables.\u003c/p\u003e\n"],["\u003cp\u003eAnother method is to set the PATH variables in a system-wide location, such as \u003ccode\u003e/etc/environment\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot common installation issues in Cloud Code for IntelliJ\n\nHow do I fix 'executable not found on PATH' errors?\n---------------------------------------------------\n\nIf, during deployment or continuous development, you are getting errors in the\nform of `executable file not found in $PATH`.\n\nFor example: \n\n```\ntime=\"2018-11-01T12:46:38-04:00\" level=fatal msg=\"exiting dev mode because the first build failed: building [gcr.io//my-proj]: tagging: pushing: getting auth config for gcr.io//my-proj:3c275201-dirty-50f870d: getting auth config: error getting credentials - err: exec: \"docker-credential-gcr\": executable file not found in $PATH, out: ``\"\n```\n\n\u003cbr /\u003e\n\nThen, you may be running into the problem where the IDE is not inheriting the\nshell environment variables. This can happen in some Linux environments when\nthe `PATH` variables are defined in `.bash_profile` or `.bash_rc` and the\nIDE is launched from the GUI, causing the IDE not to see the `PATH` variables.\n\nThis can be solved by allowing Cloud Code to automatically manage\nupdates to gcloud CLI and Kubernetes dependencies, using the Cloud Code\nsettings within your IDE (**File** \\\u003e **Settings** \\\u003e **Tools** \\\u003e **Cloud Code** \\\u003e\n**Kubernetes** or for Mac OS X, **IntelliJ IDEA** \\\u003e\n**Preferences** \\\u003e **Tools** \\\u003e **Cloud Code** \\\u003e **Kubernetes**).\n\nIf you'd like to maintain custom versions of these dependencies, you can\nsolve this issue in Linux using the following workaround:\n\n- Launch the IDE from the terminal\n\n First, follow these instructions to enable a command-line launcher. Then\n launch the IDE from the terminal.\n\n For example, to launch IntelliJ IDEA from the terminal, navigate to\n the project you wish to open, then execute: \n\n idea .\n\n Similarly, to launch PyCharm, execute: \n\n charm .\n\n- Alternatively, set the `PATH` variables in a system-wide location such\n as /etc/environment.\n\nDiagnosing and reporting an issue\n---------------------------------\n\nIf your issue isn't covered in this doc, try finding a resolution to the issue\nby:\n\n- Searching the [Cloud Code for IntelliJ GitHub issues](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues?q=is%3Aissue+)\n and/or [StackOverflow](https://stackoverflow.com/search?q=%5Bgoogle-cloud-code%5D)\n for a similar problem\n\n- Joining the [`#cloud-code`](https://googlecloud-community.slack.com/messages/cloud-code/)\n channel, which is part of the [Google Cloud Slack community](https://join.slack.com/t/googlecloud-community/shared_invite/zt-2mz6i6j8l-qMC13DEg6FAtGMH4wVytTA),\n and asking about the issue, where one of the community members may be able to\n identify the problem\n\nIf you couldn't resolve the issue after trying to diagnose it, then you can\nreport the issue in the IntelliJ IDE:\n\n1. Click **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit feedback or\n report an issue**. This prompts you to report an issue on GitHub.\n\n2. Follow the template in the issue reporting box to describe the issue."]]