@@ -30,21 +30,18 @@ You may add a note and expiration date to the token. You can leave the scopes fi
30
30
31
31
## Connect to Nebari via SSH
32
32
33
- Before you being , you'll need to have SSH installed on your local machine. From a terminal, use `ssh` to begin the connection.
33
+ Before you begin , you'll need to have SSH installed on your local machine. From a terminal, use `ssh` to start the connection.
34
34
35
35
`ssh <your-nebari-domain.com> -l <your-username> -p 8022`
36
36
37
37
:::important
38
- The syntax for `<your-nebari-domain.com>` is important - do not include `https://` or a trailing `/`.
39
-
40
- If you have the incorrect syntax, it will result in the error:
41
-
42
- `Could not resolve hostname <your-nebari-domain.com>: nodename nor servname provided, or not known`
38
+ The syntax for `<your-nebari-domain.com>` is important - do not include `https://` or a trailing `/`. If you have the incorrect syntax, it will result in the error:
39
+ ```Could not resolve hostname <your-nebari-domain.com>: nodename nor servname provided, or not known```
43
40
:::
44
41
45
42
You will then be prompted for your password. Enter the token as the password and press `Enter`.
46
43
47
- If you don't already have a JupyterLab server running on your Nebari instance, it may take several minutes for the server to start up. The `ssh` connection has it's own timeout period which is likely shorter than the time it takes to spinup a new server. Therefore, you may see the following error as the `ssh` connection times out:
44
+ If you don't already have a JupyterLab server running on your Nebari instance, the server may take a few minutes to start up. The `ssh` connection has its own timeout period, likely shorter than the time it takes to spin up a new server. Therefore, you may see the following error as the `ssh` connection times out:
48
45
49
46
`Starting your server............................................failed to start server on time!`
50
47
@@ -54,10 +51,27 @@ Once the connection is complete, you will have terminal access to your JupyterLa
54
51
55
52
## Use SFTP to transfer files to/from Nebari
56
53
57
- SFTP, which stands for _Secure File Transfer Protocol_, is a protocol built into SSH that can implement file transfer commands over a secure connection. The SFTP port on Nebari is 8023 .
54
+ By default, SFTP uses the SSH protocol to authenticate and establish a secure connection. Because of this, the same authentication token used previously in its SSH counterpart can be used here .
58
55
59
56
Utilizing SFTP will depend on how your local machine is configured and the utility you're using for SFTP. In some cases, your SSH configuration will allow SFTP to work " out of the box" . Other times, special SFTP setup is required in your SSH configuration to allow for these connections.
57
+ Similar to `ssh`, from a terminal, use `sftp` to begin a new connection:
58
+ ```sftp <your-nebari-domain.com> -l <your-username> -p 8023```
59
+
60
+ ### Transferring Files with SFTP
61
+
62
+ Downloading Files:
63
+
64
+ - Use the `get` command to download files from the remote host:
65
+ - `get <remote-file>` downloads the file with the same name to the local system.
66
+ - `get <remote-file> <local-file>` downloads and saves the file with a different name.
67
+ - To download a directory and its contents, use `get -r <some-directory>`.
68
+ - To maintain permissions and access times, use `get -Pr <some-directory>`.
69
+
70
+ Uploading Files:
60
71
72
+ - Use the `put` command to upload files to the remote system:
73
+ - `put <local-file>` uploads the file.
74
+ - To upload a directory and its contents, use `put -r <some-directory>`.
61
75
## Dangerous, but useful information
62
76
63
77
:::warning
0 commit comments