> For the complete documentation index, see [llms.txt](https://docs.ccv.brown.edu/oscar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ccv.brown.edu/oscar/connecting-to-oscar/open-ondemand/using-file-explorer-on-ood.md).

# Using File Explorer on OOD

The filesystem on Oscar can be accessed through the file explorer on this web portal. The file explorer allows you

* List files
* Create a directory
* Rename files
* [Edit plain-text files](#edit-plain-text-files)
* [Upload files or directories](#upload-files-or-directories)
* [Download files or directories](#download-files-or-directories)
* Copy/Move files
* [Launch a terminal from the current directory](#undefined)

To access the file explorer, click "Files" -> "Home Directory" at the top of the screen.

![File explorer menu showing Files and Home Directory option](/files/Oc8PtVV91COgKLjfFei6)

Check the documentation below for some of these services below:

## Changing directories on File explorer

To access a directory, click "Change directory" and enter the path name

{% hint style="info" %}
Do not use "\~" in your directory path name. The path should start with "/users" or "/oscar/"
{% endhint %}

* To access your home directory, click the "**Home Directory**" link on the left. The path name at the top of the page should change to "/users/\<username>"
* To access your scratch directory, click the "scratch" directory in your home directory **OR** click "Change directory" and enter "/users/\<username>/scratch"
* To access your data directory, click the "data" directory in your home directory **OR** click "Change directory" and enter "/users/\<username>/data"

### Edit plain-text files

1. [Navigate to the directory](#changing-directories-on-file-explorer) that contains the plain-text file.
2. Click the icon with the three dots -> Edit
3. The file will open in a text editor in a new tab

![Edit file option in three dots menu](/files/j9ksFQQXloVgKJBmnCR3)

### Download files or directories

1. [Navigate to the directory](#changing-directories-on-file-explorer) that contains the file or directory.
2. Click the icon with the three dots -> Download

![Download option in three dots menu](/files/namEAzhp9qldYnoiDhid)

To download multiples files:

1. Click the check-box to the left of the file name.
2. Scroll to the top of the page and click "Download"

Directories are downloaded as zipped files on your computer.

### Upload files or directories

1. [Navigate to the directory](#changing-directories-on-file-explorer) where you need to upload the files.
2. Click the "Upload" button.
3. Follow the instructions on the screen. You can click the "Browse" buttons or drag and drop files.

![Upload button in file explorer](/files/AQp8C63yJPVPa5HT1qXQ)

### Launch a terminal

1. [Navigate to the directory](#changing-directories-on-file-explorer) where you would like to open the terminal
2. Click "Open in Terminal" at the top of the page.
3. A web-based terminal will open in a new tab of your browser. You will be logged into one of the login nodes.

![Open in Terminal button in file explorer toolbar](/files/z9FlxCoL7F01F35QTiLJ)