# How to Connect

After renting a GPU server on Clore.ai, you can connect via SSH or access pre-installed services like Jupyter Notebook.

## Connection Information

Once your order is active, you'll find connection details in:

1. **My Orders** page → Click on your active order
2. **Order details** will show: IP address, SSH port, and credentials

## SSH Connection

### Linux / macOS

Open Terminal and run:

```bash
ssh root@<IP_ADDRESS> -p <PORT>
```

Example:

```bash
ssh root@185.123.45.67 -p 22022
```

### Windows

**Using PowerShell:**

```powershell
ssh root@<IP_ADDRESS> -p <PORT>
```

**Using PuTTY:**

1. Download [PuTTY](https://putty.org)
2. Enter the IP address in "Host Name"
3. Enter the port number in "Port"
4. Click "Open"
5. Login as `root` with the provided password

## SSH Keys (Recommended)

For passwordless login, add your SSH public key:

1. Go to **Account** → **SSH Keys**
2. Click **Add Key**
3. Paste your public key (usually `~/.ssh/id_rsa.pub`)
4. Save

Your key will be automatically deployed to new rentals.

### Generate SSH Key (if you don't have one)

```bash
ssh-keygen -t rsa -b 4096
```

## Jupyter Notebook Access

Many images come with Jupyter pre-installed:

1. Check your order details for the Jupyter URL
2. Open the URL in your browser (usually `http://<IP>:<JUPYTER_PORT>`)
3. Enter the token shown in your order details

## File Transfer

### Using SCP

Upload file to server:

```bash
scp -P <PORT> /local/file.txt root@<IP>:/remote/path/
```

Download file from server:

```bash
scp -P <PORT> root@<IP>:/remote/file.txt /local/path/
```

### Using rsync

For larger transfers or syncing directories:

```bash
rsync -avz -e "ssh -p <PORT>" /local/folder/ root@<IP>:/remote/folder/
```

## Port Forwarding

To access services running on the server locally:

```bash
ssh -L 8080:localhost:8080 root@<IP> -p <PORT>
```

This forwards server port 8080 to your local port 8080.

## Common Issues

| Issue              | Solution                                                                  |
| ------------------ | ------------------------------------------------------------------------- |
| Connection refused | Check if the server is fully booted (wait 2-3 minutes after order starts) |
| Permission denied  | Verify password/SSH key is correct                                        |
| Connection timeout | Check if the port is correct                                              |
| Host key changed   | Remove old key: `ssh-keygen -R [<IP>]:<PORT>`                             |

## Useful Commands After Connecting

Check GPU status:

```bash
nvidia-smi
```

Check available disk space:

```bash
df -h
```

Check system resources:

```bash
htop
```


---

# 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.clore.ai/for-renters/how-to-connect.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.