# Cloud

The cloud feature basically allows you to sync/download and upload the complete data of a Databox Object to a MySQL database.\
Please follow these instructions carefully to install the Databox cloud to your webserver.

> You will need a MySQL database and your server must support PHP. Please refer to your webhosting company if you are not sure how to setup a MySQL database.

### Configuration

1. Navigate to the `CloudSerivce` folder inside of the Databox unity project folder.
2. Open the `config.php` file with your default text editing tool.
3. You will see following text:

```csharp
$dbhost = 'localhost';
$dbuser = 'MySQL user';
$dbpass = 'MySQL password';
$dbname = 'MySQL database';
$dbtable = 'Databox';
```

Please add the string information according to your MySQL database setup. The `dbtable` name will be used during the Databox cloud setup you can leave it like this or change it.

4. Save the `config.php` file
5. Connect to your webserver via FTP and create a new folder.
6. Upload all files located in the `CloudService` folder to your newly created folder via FTP.
7. Open your default web browser and navigate to the `setup.php` file which is located in the newly created folder. So if you have uploaded all files to a folder called "databox", navigate to: <http://mywebserver.com/databox/setup.php>
8. You should now see the databox setup screen.\
   &#x20;[![cloudsetup](https://github.com/doorfortyfour/DataboxDocumentation/raw/master/docs/img/cloudSetup.png)](https://github.com/doorfortyfour/DataboxDocumentation/blob/master/docs/img/cloudSetup.png)
9. Click on install.
10. Databox Cloud has been installed on your server.\
    [![cloudConfig](https://github.com/doorfortyfour/DataboxDocumentation/raw/master/docs/img/cloudConfiguration.png)](https://github.com/doorfortyfour/DataboxDocumentation/blob/master/docs/img/cloudConfiguration.png)
11. You can now use the server url in the unity databox object. (the folder where you have uploaded all files) Example: <http://mywebserver.com/databox>

### Unique ID

> You can use the Unique id in the configuration to create different upload versions for different Databox Objects or for different team members.

## Sync to cloud

It is always wise to save your file before doing a sync.

`1. Check`\
Before you can sync you'll need to click on the `1. Check` button. This will check if the connection to the cloud is ready and which version is newer - local version or cloud version.\
`2. Sync & Compare`\
After the check has been accomplished you can click on `2. Sync & Compare`. This will sync to the newest version. You will see all changes in the output.\
`3. Revert`\
If you don't like the changes you can then click on `3. Revert`. This will revert the data back to the version before sync. `Force Upload`\
Forcing an upload overrides the cloud version with your local version. No matter which version is newer! `Force Download`\
Forcing a download overrides the local version with the cloud version. No matter which version is newer!

{% hint style="warning" %}
Warning! Only use force upload and download if you know what you do.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://giantgrey.gitbook.io/databox-documentation/cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.