Drive
######

Overview
*********
In Nano's file sharing system, a Drive is a representation of a local folder on your computer. You can create as many Drives as you want.

Create Drive
*************

.. HINT::
  This process is best done on the Nano webapp

Creating a Drive requires a Nano user account. To create an account, please read the :ref:`getting-started-registration` article.

To create a Drive using the Nano client, first start your downloaded Nano client software. The software will prompt you to enter your Nano user account credentials. 

After logging in, navigate to *Nano -> Configure -> Drive manager*, which will open the Drive configuration manager window.

In the Drive configuration manager window, you will see a list of your currently set-up Drive folders. If it's your first time setting up a Drive, this list will be empty. 

Click on the *Create drive* button, and choose a folder you wish to create a Drive from.

After choosing, you will see the path of the chosen folder appearing in the Drive configuration manager list.

It's a good rule-of-thumb to never make a Drive out of your root system folder, ``C:/`` folder or user folder. You always have to consider that these folders would be accessible to other Nano users if this Drive were attached to a Room with multiple users.

Delete Drive
*************

.. HINT::
  This process is best done on the Nano webapp

To delete a Drive navigate to *Nano -> Configure -> Drive manager*, which will open the Drive configuration manager window.

In the Drive configuration manager window, you will see a list of your currently set-up Drive folders. 

Right-click on the Drive you wish to delete, and select *Delete drive*. This will remove the Drive from the Nano file sharing manager.

.. HINT::
   Deleting a Drive will keep the local folder intact, the origin folder will not be deleted from the local filesystem.

Attach to Room
***************

Attaching a room (server entity) to a drive (local/Nano entity) securely requires the Owner to provide Nano the current permission configuration of the room. This ensures that the Nano will only serve any room, starting from the state the Owner has verified. The web application conveniently presents this process, but it can be performed on the client as well. Attaching rooms using the UI of the Nano client is primarily necessary when the ``remote_admin_policy`` is set to ``deny`` and it can't be performed from the web application.

To attach a Room to a Drive navigate to *Nano -> Configure -> Drive manager*, which will open the Drive configuration manager window.

Right click on the Drive you want to attach the Room to and select "Attach room to drive". Follow the instructions in the window that comes up.