Load Data From Your Local File System
Flat files are a very common data storage option, and lots of our customers will use them at some time. This tutorial will show you how to load a dataset from a file (for example, a CSV or JSON file) on disk into Saturn Cloud.
Before starting this, you should create a Jupyter server resource. See our quickstart if you don’t know how to do this yet.
Upload Files in the UI
If you want to place a flat file in your Saturn Cloud Jupyter server, there’s a simple UI option.
Simply select the file(s) you want to access and they will be uploaded!
Upload Files via SSH
If you prefer to upload your local files programatically, Saturn Cloud makes it easy to copy files from your local machine via SSH.
Set up SSH Keys
You will need to set up SSH to make the connection between Saturn Cloud and your local machine. The first step is to create a SSH key pair.
If you need help setting up your SSH keys on your laptop, you can find some good references here:
Once you have your key pair set up, you will need to add your SSH Public Key to your Saturn Cloud account. The SSH Private Key will stay on your laptop.
Add Your SSH Credentials to Saturn Cloud
Sign in to your Saturn Cloud account and select Credentials from the menu on the left.
This is where you will add your SSH credential information. This is a secure storage location, and it will not be available to the public or other users without your consent.
At the top right corner of this page, you will find the New button. Click here, and you will be taken to the Credentials Creation form.
Select SSH Public Key, give it an appropriate name, and copy the whole contents of your Public Key file into the Value section.
With this complete, your SSH credentials will be accessible by Saturn Cloud resources!
Enable SSH for a Jupyter Resource
On the resource page, click the pencil/paper icon to edit the resource details. If it is running, you may want to stop it since the resource will restart itself automatically when you make this change.
You will be taken to a page that allows you to edit the settings of the server. Check the box that says “Allow SSH Connections” and click Save at the bottom of the page.
Start the Jupyter server now, and you will see an SSH URL provided on the instance’s card.
Note: This URL may change if the server is stopped, including after auto-shutoff. When you start a work session, you may need to copy the new URL.
Transfer Files via SCP
scp command allows you to copy files over SSH connections. To use it, all you need to do is specify the local path to file you want to transfer, the SSH URL, and the path you want the file transferred to in your Saturn Cloud instance.
From the command line on your local machine, the
scp command takes the following format:
scp "local-filepath" saturn-cloud-ssh-url:"remote-filepath"
So your command might look like:
scp "test_file.py" email@example.com:"project/scripts/"
And that’s it! If you look in your resource’s file system, you will see the file.
Need help, or have more questions? Contact us at:
- On Intercom, using the icon at the bottom right corner of the screen
We'll be happy to help you and answer your questions!