Overview

QuickStart

6min

1) Create account & add credit

Before you can rent a machine on Vast.ai, you will need to setup an account and add a method of funding. Go to the billing page of the console and click on the Create Account link to setup a username and password.

Vast works on a credit system. You will need to add credits to your account before you can rent an instance. Click on the Add Credit button to see the billing options. Adding a credit card is the simplest method. Crypto payments through Crypto.com and Coinbase are also supported. You can select an initial deposit amount and follow the selected payment flow. Once that completes the amount of credit purchased will be added to the account and appear in the upper right.

Once you spend that balance down, your instances will be stopped until you add additional credits. To prevent that from happening, you can set a billing threshold and have your card auto-charged with your credit balance goes below the threshold you set. We recommend setting an auto-charge threshold greater than your daily spend rate, and a low-balance email threshold a bit lower so that you get an email if the auto-charge billing attempt fails for whatever reason.

2) Select and customize a template

A template contains a Linux docker image, related settings and launch mode(s) for connecting to the machine. Built in Jupyter and SSH are supported. Click on the edit image & config button in the upper left and then on the recommended tab to see the common templates.

Document image


Read the template descriptions and pick one that suits your use case by clicking the select button. Click the blue select button to activate the template.

Any template that uses the Jupyter HTTPS launch mode will require you to install a certificate on your local machine. On macOS, this is required. Windows and Linux will show a bypassable warning if the cert is not installed. To install the Jupyter certificate for Vast, follow the instructions [here](https://vast.ai/docs/renting/edit-docker-image-and-configuration#jupyter-direct-https-launch-mode).

To use SSH, you will need to create an SSH key and upload the public portion to Vast. Learn more here.

3) Filter machines

Use the filters to specify the GPU number, type and other factors such as port ranges, number of CPUs, amount of GPU ram and more. Each filter will narrow the offers displayed. If you see few or zero search results, reset your filters.

4) Select Storage

Make sure to use the storage slider on the left of the create page to choose your storage allocation size. You can't change this after instance creation, so make sure to size correctly at start!

5) Rent

Hitting the blue RENT button will accept the offer and create an instance with the specified docker image and launch mode. Once rented, the instance will appear in the Instances tab.

6) Enjoy

If the docker image is cached your instance should load in a minute or less depending.If the image is not cached, it will go through stages of downloading which can take 10 minutes to an hour depending on internet speeds. After loading the instance will startup. If your image uses the open button this will transition from connecting to open once an application starts responding on the port. If your image uses ssh or jupyter, you can access those through their own buttons on the instance control panel.

7) Destroy

Make sure to destroy instances after you are done with them. Stopping the instance will prevent GPU charges but you will still accrue charges for the instance storage allocation. Stopped instances can be restarted if/when the GPU is available.

Updated 25 Mar 2024
Doc contributor
Did this page help you?