Stash Home [<STASH_HOME>] cannot be created

Troubleshooting Installation

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Symptoms

On first accessing Stash during installation, an error like the following is shown:

Other similar error messages may be:

  • Stash Home [<STASH_HOME>] is not a directory
  • Stash Home [<STASH_HOME>] exists but is not readable by Stash
  • Stash Home [<STASH_HOME>] exists but is not writable by Stash
  • Stash Home [<STASH_HOME>] exists but is not accessible by Stash (no execute permission)
  • Stash Home [<STASH_HOME>] cannot be created or Stash does not have permission to access it

The Stash home directory is where your Stash data is stored.

Diagnosis

All these errors relate to permissions on the directory you have configured for <STASH_HOME>.

Cause

  • Stash Home [<STASH_HOME>] is not a directory
    The configured STASH_HOME already exists but is not a directory.
  • Stash Home [<STASH_HOME>] exists but is not readable by Stash
    The operating system user running Stash does not have permission to read the configured STASH_HOME.
  • Stash Home [<STASH_HOME>] exists but is not writable by Stash
    The operating system user running Stash does not have permission to read the configured STASH_HOME.
  • Stash Home [<STASH_HOME>] exists but is not accessible by Stash (no execute permission)
    The operating system user running Stash does not have permission to access the configured STASH_HOME - on a UNIX style system (including MacOS), this means the user does not have the execute permission.
  • Stash Home [<STASH_HOME>] cannot be created or Stash does not have permission to access it
    On Windows it may be one of the following:
    • The operating system user running Stash does not have permission to create the configured STASH_HOME.
    • The STASH_HOME exists, but is within a directory or drive to which the user running Stash does not have access.
    • The STASH_HOME may contain illegal file name characters. (See MSDN: Naming Files, Paths and Namespaces)
    On UNIX style systems (including Mac OS)
    • The operating system user running Stash does not have permission to create the configured STASH_HOME.
    • The STASH_HOME exists, but is within a directory to which the user running Stash does not have access.

Resolution

Do one of the following:

  • Correct the permissions on the directory configured for <STASH_HOME> so that the operating system user running Stash has access, and can read and write. See Stash home directory for instructions on setting <STASH_HOME>.
  • Use a different STASH_HOME to which the operating system user running Stash has access, and can read and write.

 

 

   

 

 

Last modified on Nov 2, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.