> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataerai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Sign in to Dataerai, create a project, upload your first dataset, and share it with your team — in a few minutes.

Use this guide to go from a new account to a shared dataset in a few minutes.

You'll do four things:

* Sign in.
* Create a project.
* Upload a file.
* Share it with another person or group.

For the background concepts, see [Key concepts](/get-started/key-concepts).

## Before you begin

You'll need:

* A Dataerai account with an allocation.
* A data file to upload. Anything works for this walkthrough — a CSV, an image, or an instrument output file.

<Note>
  Your allocation gives you access to Dataerai resources. If you don't have one yet, ask your Dataerai administrator.
</Note>

## Sign in

<Steps>
  <Step title="Create your account">
    Open your Dataerai site and go to **Sign up**. Create an account with your **name**, **email**, and a **password**, or choose **Continue with Globus** to sign in through a trusted identity provider, such as your university or Google.
  </Step>

  <Step title="Verify your email">
    If you created a Dataerai email/password account, Dataerai emails you a verification link. Open it to activate your account, then sign in. Email verification is only required for Dataerai email/password accounts, not Globus sign-in.
  </Step>
</Steps>

## Create a project

A **project** is a workspace for a study, grant, or effort. It holds your data and controls who can see it.

<Frame caption="Your projects on the home view — create one, then open it to add data.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/projects.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=e7c9b60091e521f3238ce0e578c13615" alt="Dataerai home view listing a project" width="1420" height="130" data-path="images/projects.png" />
</Frame>

<Steps>
  <Step title="Open the new project dialog">
    From the main view, click **New project**.

    <Frame caption="The New project action on the home view.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/nav-newproject.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=1b7896687f1dc2f33e5e97c11529f94f" alt="Dataerai New project button on the home view" width="180" height="40" data-path="images/nav-newproject.png" />
    </Frame>
  </Step>

  <Step title="Name your project">
    Give it a **Name** and an optional **Description**, then click **Create**. You become the project's **Admin**, so you can invite others and manage access.
  </Step>
</Steps>

<Tip>
  You can make a project publicly readable at creation time, or keep it private and share it selectively later. See [Sharing and permissions](/sharing/permissions).
</Tip>

## Upload your first dataset

Each piece of data in Dataerai is an **asset** — a file (or bundle of files) plus its metadata. The fastest way to add one is to upload it in the browser.

<Steps>
  <Step title="Open the upload dialog">
    Inside your project, click **Upload** — or drag a file directly onto the page.

    <Frame caption="The project toolbar — Upload, New collection, and New asset.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/nav-toolbar.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=1e7a91813900585f76a6b2442c66c8f9" alt="Dataerai project toolbar with the Upload action" width="415" height="42" data-path="images/nav-toolbar.png" />
    </Frame>
  </Step>

  <Step title="Add details">
    Give the asset a title and any **tags**. If Dataerai recognizes the file format, it shows a **metadata preview** with fields extracted from the file, which you can review before uploading.
  </Step>

  <Step title="Upload">
    Start the upload. Progress is shown live, and the asset becomes available as soon as the transfer finishes.
  </Step>
</Steps>

<Note>
  Moving many files or very large datasets? Use the high-throughput, resumable [desktop app and CLI](/data/desktop-and-cli) instead of the browser.
</Note>

## Share it

Sharing is controlled per object using three roles:

| Role      | What it allows                               |
| --------- | -------------------------------------------- |
| **Read**  | View metadata, content, and notes            |
| **Write** | Read, plus edit metadata, content, and notes |
| **Admin** | Write, plus share the object with others     |

<Steps>
  <Step title="Open permissions">
    Where you set access depends on the object:

    * **Asset** — select it, then click **Permissions** in the action bar that appears (or right-click and choose **Permissions**). The action bar only shows up once an asset is selected.
    * **Project** or **collection** — select it, then open its settings from the side panel (the gear button) and use the **Permissions** section in the dialog.

    <Frame caption="The action bar for a selected item — open Permissions.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/nav-permissions-btn.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=d86e744abe613ba1966060740a297668" alt="Dataerai action bar with the Permissions button" width="480" height="46" data-path="images/nav-permissions-btn.png" />
    </Frame>
  </Step>

  <Step title="Grant access">
    Add a person or a **group** and choose **Read**, **Write**, or **Admin**. To share with anyone who has the link, turn on **Make publicly available** — public access is always read-only, and any signed-in user with the link can view.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Key concepts" icon="book-open" href="/get-started/key-concepts">
    How organizations, projects, collections, assets, and datasets fit together.
  </Card>

  <Card title="Get data in" icon="upload" href="/data/upload">
    Browser uploads, metadata extraction, and the desktop app and CLI.
  </Card>

  <Card title="Organize & describe" icon="folder-tree" href="/organize/collections">
    Group data into collections and add notes and provenance.
  </Card>

  <Card title="Sharing & permissions" icon="share-2" href="/sharing/permissions">
    Roles, groups, and public links.
  </Card>
</CardGroup>
