> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot mounts

For more general information, see how to [troubleshoot development](/docs/troubleshooting/general).

## Overlapping folders

If you have a mount with the same name as a directory you've committed to Git or you create such a directory during the build,
you get a message like the following:

```bash theme={null}
W: The mount '/example' has a path that overlaps with a non-empty folder.
The content of the non-empty folder either comes from:
- your git repository (you may have accidentally committed files).
- or from the build hook.
Please be aware that this content isn't accessible at runtime.
```

This shows that the files in Git or from your build aren't available after the build.
The only files that are available are those in your mount.

To make the files available in the mount, copy them to a plain directory during the build, then copy them into the mount in the deploy hook.

<Warning>
  Do not use `/tmp` as the intermediate location. `/tmp` is itself a mount and is not available during the build phase.
</Warning>

1. In the `build` hook, move the files to a plain directory (not a mount).

   ```bash theme={null}
   mkdir -p tmpdir
   mv example tmpdir/example
   ```

2. In the `deploy` hook, use `cp` to copy the files into the mount.

   ```bash theme={null}
   cp -r tmpdir/example example
   ```

To see the files without copying them, temporarily remove the mount from your app configuration.
Then SSH into your app and view the files.
You can then put the mount back in place.

## Mounted files not publicly accessible

If you've set up mounts to handle files like user uploads, you want to make sure the files are accessible.
Do so by managing their [location](/docs/configure-apps/image-properties/web#locations).

This example defines two mounts, one named `private` and one `upload`:

```yaml .upsun/config.yaml theme={null}
applications:
  myapp:
    mounts:
      'private':
        source: storage
        source_path: private
      'uploads':
        source: storage
        source_path: uploads
```

With only this definition, their behavior is the same.
To make `uploads` accessible, define a location with different rules as in the following example:

```yaml .upsun/config.yaml theme={null}
applications:
  myapp:
    web:
      locations:
        '/':
          # Handle dynamic requests
          root: 'public'
          passthru: '/app.php'
        # Allow uploaded files to be served, but don't run scripts.
        '/uploads':
          root: 'uploads'
          expires: 300s
          scripts: false
          allow: true
```

## Mounts starting with a dot ignored

Upsun ignores YAML keys that start with a dot.
This causes a mount like `.myhiddenfolder` to be ignored.
To mount a directory starting with a dot, put a `/` at the start of its definition:

```yaml .upsun/config.yaml theme={null}
applications:
  myapp:
    web:
      mounts:
        '/.myhiddenfolder':
          source: storage
          source_path: 'myhiddenfolder'
```

## Disk space issues

If you are worried about how much disk your mounts are using, check the size with the following command:

```bash theme={null}
upsun resources:get
```
