> For the complete documentation index, see [llms.txt](https://hmbaier.gitbook.io/distributed-ml-w-and-m/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hmbaier.gitbook.io/distributed-ml-w-and-m/logging-in-and-setting-up-your-hpc-account/login-and-basic-setup.md).

# Login & Basic Setup

### Logging In

Open a terminal on your computer and type: 

```
ssh [wm_username]@[subcluster_name].sciclone.wm.edu
```

For this example, we'll be logging into the Vortex sub-cluster, so type 'vortex' in place of \[subcluster\_name]. When prompted for a password, enter your W\&M password.

Your terminal should now look similar to this:

![](/files/i3EaM1xFu0XDbbtGKI5p)

### Home Directory

Type `pwd` (print working directory) into your terminal. It should print out: `/sciclone/home20/<wm_username>`.

This is your landing directory - you'll open to this every time you login.

Now type `ls` into your terminal. If this is the first time you are logging in, you should see 4 folders print out. You can find read more about the purpose of each of these folders here: <https://www.wm.edu/offices/it/services/researchcomputing/using/files/index.php>

### Working Directories

You are free to make as many folders here (in home20) as you like, as long as you *do not* store large amounts of data in them.

Best practice is to store code files within your home20 directory and data within a folder provided to you by Dan (or another professor) in either `/sciclone/geograd/` or `/sciclone/geounder/`

You can make a new folder using the `mkdir <folder_name>` command


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://hmbaier.gitbook.io/distributed-ml-w-and-m/logging-in-and-setting-up-your-hpc-account/login-and-basic-setup.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.