topic Cluster cannot find init script stored in Volume in Get Started Discussions

Cluster cannot find init script stored in Volume

jimoskar — Mon, 06 Oct 2025 13:13:12 GMT

I have created an init script stored in a Volume which I want to execute on a cluster with runtime 16.4 LTS. The cluster has policy = Unrestricted and Access mode = Standard. I have additionally added the init script to the allowlist. This should be sufficient per the documentation. However, when I try to start the cluster, I get

cannot execute: required file not found

when I try to start the cluster. Anyone who knows how to fix this? I am the owner of the volume where the script is stored, so access should not be an issue.

Re: Cluster cannot find init script stored in Volume

szymon_dybczak — Mon, 06 Oct 2025 14:18:14 GMT

Hi @jimoskar ,

Since you're using standard access mode you need to add init script to allowlist. Did you add your init script to allowlist? If not, do the following:

In your Databricks workspace, click Catalog.
Click the gear icon .
Click the metastore name to open the metastore details and permissions UI.
Select Allowed JARs/Init Scripts.
Click Add.

Next add an init script to the allowlist perform following steps:

For Type, select Init Script.
For Source Type, select Volume or the object storage protocol.
Specify the source path to add to the allowlist. See How are permissions on paths enforced in the allowlist?.

Re: Cluster cannot find init script stored in Volume

szymon_dybczak — Mon, 06 Oct 2025 18:56:07 GMT

Hi @jimoskar ,

Another possibility I can think of is that during cluster startup, the init script path is resolved using the cluster owner's privileges. If the owner lacks access to the volume or script, the initialization fails even if the user starting the cluster does have the necessary permissions.

To identify the creator or owner of a cluster:

Navigate to the cluster configuration UI.
Click the kebab menu and select JSON.
In the JSON view, look for the field creator_user_name to find the creator’s username.

To grant the necessary permissions on the volume:

Navigate to the Catalog Explorer.
Click on the catalog that contains the volume.
Go to the Permissions tab.
Click the Grant button.
Assign the required permissions on the volume to the creator.

The following image shows the UI after navigating to the Permissions tab and highlights the Grant button location on the screen.

Re: Cluster cannot find init script stored in Volume

jimoskar — Tue, 07 Oct 2025 10:31:27 GMT

Hi @szymon_dybczak,

Thank you for your suggestions! I have added the init script to the allowlist. Additionally, my user is the creator of the compute, and has ALL PRIVELEGES on the Catalog where the init script is stored. However, I still get the same error.

Do you have any other suggestions for possible solutions?

Re: Cluster cannot find init script stored in Volume

szymon_dybczak — Tue, 07 Oct 2025 12:12:46 GMT

Hi @jimoskar ,

Yep, I have some other ideas that we can check. In databricks you have 2 kinds of init scripts:

- global init scripts - a global init script runs on all clusters in your workspace configured with dedicated (formerly single user) or legacy no-isolation shared access mode. So it seems that global init script are supported only for those access mode.

- Cluster-scoped init scripts - Cluster-scoped init scripts are init scripts defined in a cluster configuration. Cluster-scoped init scripts apply to both clusters you create and those created to run jobs.

So, do you happen to use global init script? Because it could be one explanation why it doesn't work in your case.

Another thing to check - what is the size of your init script? In docs they mentioned that:

"The init script cannot be larger than 64KB. If a script exceeds that size, the cluster will fail to launch and a failure message will appear in the cluster log."

Also, you can try to check init script logs. Maybe we will find some additional info/error message there?

And last, but not least you can check below articles. It seems that Windows Notepad and similar editors insert special characters like carriage returns (\r), that could cause some issues:

Init scripts failing with unexpected end of file error - Databricks

Init script stored on a volume fails to execute on cluster start - Databricks

Re: Cluster cannot find init script stored in Volume

jimoskar — Thu, 09 Oct 2025 07:46:23 GMT

The culrpit was the carriage returns, so removing those in VSCode fixed the error. Thanks a ton @szymon_dybczak !

Re: Cluster cannot find init script stored in Volume

szymon_dybczak — Thu, 09 Oct 2025 07:49:06 GMT

Hi @jimoskar ,

Thanks for letting us know. I really appreciate it. And great that it worked!