# Preparation

There are some things we need to do in preparation to install this service.

## Environment

### General

<details id="bkmrk-tz-this-is-the-curre"><summary>DOMAIN</summary>

This is the full domain and sub-domain that the service will be available at.

<p class="callout info">*For example:* collabora.example.com</p>

</details><details id="bkmrk-gid-%C2%A0"><summary>ALIASGROUP1</summary>

This is the full domain and sub-domain for your OwnCloud installation, allowing you to integrate the two services.

<p class="callout info">*For example:* owncloud.example.com</p>

</details><details id="bkmrk-pgid-this-is-the-num"><summary>USERNAME</summary>

This is the username used by the OwnCloud service to connect with the Collabora service.

<p class="callout info">*For example:* owncloud</p>

</details>### Passwords

<p class="callout danger">Keep these securely stored in a password manager, such as [VaultWarden](https://hub.subspace.services/books/vaultwarden "VaultWarden").</p>

<details id="bkmrk-password-this-is-the"><summary>PASSWORD</summary>

This is the password that will be used for root access to the database.

<p class="callout warning">It is important to use secure, randomly generated password.</p>

You can use a random alphanumeric string from a password manager, or open the terminal and run the command:

```bash
tr -dc 'A-Za-z0-9!"#$%&'\''()*+,-./:;<=>?@[\]^_`{|}~' </dev/urandom | head -c 32; echo
```

This pulls a random string from the '[urandom](https://en.wikipedia.org/wiki//dev/random)' device, removes unwanted characters and trim it to an appropriate length.

</details>