[Yandex Cloud documentation](../index.md) > [Yandex StoreDoc](index.md) > Getting started

# Getting started with Yandex StoreDoc

To get started:


* [Create a cluster](#cluster-create).
* [Connect to the database](#connect).



## Getting started {#before-you-begin}

1. Navigate to the [management console](https://console.yandex.cloud) and log in to Yandex Cloud or sign up if not signed up yet.

1. If you do not have a folder yet, create one:

   1. In the [management console](https://console.yandex.cloud), in the top panel, click ![image](../_assets/console-icons/layout-side-content-left.svg) or ![image](../_assets/console-icons/chevron-down.svg) and select the [cloud](../resource-manager/concepts/resources-hierarchy.md#cloud).
   1. To the right of the cloud name, click ![image](../_assets/console-icons/ellipsis.svg).
   1. Select ![image](../_assets/console-icons/plus.svg) **Create folder**.
   
      ![create-folder1](../_assets/resource-manager/create-folder-1.png)
   
   1. Give your [folder](../resource-manager/concepts/resources-hierarchy.md#folder) a name. The naming requirements are as follows:
   
       * Length: between 3 and 63 characters.
       * It can only contain lowercase Latin letters, numbers, and hyphens.
       * It must start with a letter and cannot end with a hyphen.
   
   1. Optionally, specify the description for your folder.
   1. Select **Create a default network**. This will create a [network](../vpc/concepts/network.md#network) with subnets in each availability zone. Within this network, you will also have a [default security group](../vpc/concepts/security-groups.md#default-security-group), within which all network traffic will be allowed.
   1. Click **Create**.
   
      ![create-folder2](../_assets/resource-manager/create-folder-2.png)

1. [Assign](../iam/operations/roles/grant.md) the [vpc.user](../vpc/security/index.md#vpc-user) role and the [managed-mongodb.editor role (or higher)](security/index.md#roles-list) to your Yandex Cloud account. These roles provide the permissions needed to create a cluster.

    {% note info %}
    
    If you cannot manage roles, contact your cloud or organization administrator.
    
    {% endnote %}

1. You can connect to database clusters both from within and outside Yandex Cloud:

   * To connect from within Yandex Cloud, create a [Linux](../compute/quickstart/quick-create-linux.md)-based VM in the same cloud network as your database cluster.

   * To connect to your cluster from the internet, request public access to its hosts when creating it.

   {% note info %}

   The next step requires connecting to the cluster from a [Linux](../compute/quickstart/quick-create-linux.md)-based VM.

   {% endnote %}

1. [Connect](../compute/operations/vm-connect/ssh.md) to your VM over SSH.

1. Install MongoDB Shell:

   ```bash
   cd ~/ && \
   wget https://repo.mongodb.org/apt/ubuntu/dists/focal/mongodb-org/4.4/multiverse/binary-amd64/mongodb-org-shell_4.4.1_amd64.deb && \
   sudo dpkg -i mongodb-org-shell_4.4.1_amd64.deb
   ```
   

## Create a cluster {#cluster-create}

1. In the [management console](https://console.yandex.cloud), select the folder where you want to create your database cluster.
1. Navigate to **Yandex StoreDoc**.
1. Click **Create cluster**.
1. Specify the cluster settings and click **Create cluster**. For more information, see [Creating a cluster](operations/cluster-create.md).
1. Wait until the cluster is ready: its status on the Yandex StoreDoc dashboard will change to **Running**, and its state to **Alive**. This may take a while.


## Connect to the database {#connect}

1. If using security groups for the cloud network, [configure them](operations/connect/index.md#configuring-security-groups) to allow all required traffic between the cluster and your connection host.

1. Obtain an SSL certificate:

   {% list tabs group=operating_system %}
   
   - Linux (Bash)/macOS (Zsh) {#linux-macos}
   
      ```bash
      mkdir -p ~/.mongodb && \
      wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
           --output-document ~/.mongodb/root.crt && \
      chmod 0644 ~/.mongodb/root.crt
      ```
   
      The certificate will be saved to the `~/.mongodb/root.crt` file.
   
   - Windows (PowerShell) {#windows}
   
      ```powershell
      mkdir $HOME\.mongodb; curl.exe -o $HOME\.mongodb\root.crt https://storage.yandexcloud.net/cloud-certs/CA.pem
      ```
   
      The certificate will be saved to the `$HOME\.mongodb\root.crt` file.
   
      Your corporate security policies and antivirus software may block the certificate download. For more information, see [FAQ](qa/storedoc.md#get-ssl-error).
   
   {% endlist %}

1. Connect to the cluster using the MongoDB CLI:

   ```bash
   mongo --norc \
         --ssl \
         --sslCAFile ~/.mongodb/root.crt \
         --host '<Yandex_StoreDoc_host_1_FQDN>:27018,...,<Yandex_StoreDoc_host_N_FQDN>:27018' \
         --username <DB_username> \
         --password <DB_user_password> \
         <DB_name>
   ```

    To learn how to get a host’s FQDN, see [this guide](operations/connect/index.md#get-fqdn).


## What's next {#whats-next}

* Read about the [service concepts](concepts/index.md).
* Learn more about [creating a cluster](operations/cluster-create.md) and [connecting to a database](operations/connect/index.md).
* View the "Yandex StoreDoc guide" webinar on [YouTube](https://www.youtube.com/live/uTt52jcvJ98) or [Cloud Video](https://runtime.strm.yandex.ru/player/episode/vple7zg5c6ekr4mgkoqf).
* Check out the [questions and answers](qa/general.md).