.. _android/cloud-management:

Cloud Management
========================

.. image:: ../img/android/setting-cloud-services.png
    :alt: How to handle cloud services with Android
    :width: 346px

In "Cloud Services", you can create or edit the connection between the Cryptomator app and your storage provider accounts.

Please enter the credentials for your provider account or in case of Google Drive choose your account.
If your authentication was successful, some of the providers might ask you to grant Cryptomator access permission to your online files.
Please allow this permission.

In Google Drive, OneDrive and Dropbox you can only create one connection between your Cloud Service account and the Cryptomator app.
You can't connect to (for example) two different *Dropbox* accounts.

If the provider requested permission to access your online files you can remove Cryptomator permissions from your online storage account at any time.
Please keep in mind that Cryptomator then cannot connect to your vault anymore.

.. _android/cloud-management/login-dropbox:

Login Dropbox
------------------

.. image:: ../img/android/add-dropbox-login-provider-0.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-dropbox-login-provider-1.png
    :alt: How to handle cloud services with Android
    :width: 346px


.. _android/cloud-management/login-google-drive:

Login Google Drive
------------------

.. image:: ../img/android/add-googledrive-login-provider.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. _android/cloud-management/login-onedrive:

Login OneDrive
------------------

.. image:: ../img/android/add-onedrive-login-provider-0.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-onedrive-login-provider-1.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. _android/cloud-management/login-WebDAV:

Login WebDAV
------------------

Please see :ref:`misc/supported-cloud-services/clouds-with-webdav-support` for a non-exhaustive list of Cloud Services
and information about accessing them with WebDAV.

.. image:: ../img/android/add-webdav-login-provider-0.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-webdav-login-provider-1.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-webdav-login-provider-2.png
    :alt: How to handle cloud services with Android
    :width: 346px


.. note::
    While creating the WebDAV connection, please make sure to add the root of the accessible stroge and don't navigate directly into the vault.

.. _android/cloud-management/login-local-storage:

Login S3
------------------

Generate a key that has permissions "Allow List All Bucket Names". (AWS root users have this by default and `this permission may not be necessary in the future <https://github.com/cryptomator/android/issues/339>`_.)

"endpoint" refers to how the S3 API for your bucket can be reached. In the case of `official S3 <https://docs.aws.amazon.com/general/latest/gr/s3.html>`_, it would be ``s3.<region>.amazonaws.com``, for e.g. `Backblaze B2 <https://www.backblaze.com/apidocs/introduction-to-the-s3-compatible-api>`_ ``s3.<region>.backblazeb2.com``.

.. image:: ../img/android/add-s3-login-provider.png
    :alt: Android S3 connection form
    :width: 346px

Login Local Storage
-----------------------

The following pictures describes how to setup a location to access vaults stored on the internal storage of the device (the same applies for vaults located e.g. on a SD card):

.. image:: ../img/android/add-localstorage-login-provider-0.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-localstorage-login-provider-1.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-localstorage-login-provider-2.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-localstorage-login-provider-3.png
    :alt: How to handle cloud services with Android
    :width: 346px

.. image:: ../img/android/add-localstorage-login-provider-4.png
    :alt: How to handle cloud services with Android
    :width: 346px

After creating the location, you can access it by clicking on the name of the location to add a vault or create a new vault.

.. note::
    If you use a custom location please make sure to add the root folder of the storage like described in the pictures and don't navigate directly into the vault.