Comment on page

User Authentication

Registration and authentication in Deep Lake.

How to Register and Authenticate in Deep Lake
In order to use Deep Lake features that require authentication (Activeloop storage, connecting your cloud dataset to the Deep Lake UI, etc.) you should register and login with Deep Lake.
Registration
You can register in the Deep Lake App, or in the CLI using:
activeloop register -e <email> -u <username> -p <password>
Authentication in Programmatic Interfaces
After registering, you can create an API token in the Deep Lake UI (top-right corner, user settings) and authenticate in programatic interfaces using 3 options:
Environmental Variable
Set the environmental variable ACTIVELOOP_TOKEN to your API token. In Python, this can be done using:
os.environ['ACTIVELOOP_TOKEN'] = <your_token>
CLI Login 
Login in the CLI using two options:
activeloop login -u <username> -p <password>
activeloop login -t <your_token>
Credentials created using the CLI login !activeloop login expire after 1000 hrs. Credentials created using API tokens in the Deep Lake App expire after the time specified for the individual token. Therefore, long-term workflows should be run using API tokens in order to avoid expiration of credentials mid-workflow.
Pass the Token to Individual Methods
You can pass your API token to individual methods that require authentication such as:
ds = deeplake.load('hub://org_name/dataset_name', token = <your_token>)
​
​

Storage Options

Storing Deep Lake Data in Your Own Cloud