# Accessing Oscar Filesystem

By default, a Singularity image only have access to a limited set of paths once created. Without any special configurations, your $HOME (`~/`) and `/tmp/` (among a few other system-specific locations) are accessible from within a container. However, this will not automatically bind your `data/` or `scratch/` directories, and thus they will not be accessible. The easiest method to gain access to these directories is to use the **bind** functionality to mount these volumes to the container on runtime.

## Binding Using Command Line Arguments

Binding is achieved using the --bind or -B argument followed by the `<hostPath>:<containerPath>`

```bash
$ singularity shell -B /oscar/home/$USER,/oscar/scratch/$USER,/oscar/data <yourContainer.simg>
```

This will bind `/oscar/data``, /oscar/scratch and /oscar/home` from OSCAR's GPFS to `/oscar/data` and `/oscar/scratch` within the container, respectively. Doing this will allow any existing links you have to your data and scratch directories to function properly.

## Binding Using Environment Variables

An alternative approach is to use the `SINGULARITY_BINDPATH` environment variable which is used as a list of additional bind paths that will be included in any singularity commands you execute, including run and shell. Using the environment variable instead of the command line argument, this would be:

```bash
export SINGULARITY_BINDPATH="/oscar/home/$USER,/oscar/scratch/$USER,/oscar/data"
singularity run <yourContainer.simg>
```

You can add various additional command options to configure the read/write permissions for these mounted volumes. For more information regarding file or path binds, please see the official [Mounting and binding](https://singularity.lbl.gov/docs-mount) documentation from Singularity.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ccv.brown.edu/oscar/singularity-containers/accessing-oscar-filesystem.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.