# Preparation

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

## Volumes

<details id="bkmrk-media-folders-radarr"><summary>Persistent Data</summary>

This is where the service will store its own application data and ensures we can quickly update the service image.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-media-%26-documents-fo"><summary>Media &amp; Documents Folders</summary>

OwnCloud will need access to the folders where you store your media and document files. This will allow you to share them through the OwnCloud files and sharing app.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details>## Environment

### General

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

This is the current time zone formatted using the [tz database.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

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

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

This is the numeric ID of the user account on Debian. If you are unsure, open a terminal and run:

```bash
id -u
```

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

This is the numeric ID of the user account's group on Debian. If you are unsure, open a terminal and run:

```bash
id -g
```

</details>### OwnCloud

<details id="bkmrk-owncloud_trusted_dom"><summary>OWNCLOUD\_TRUSTED\_DOMAINS</summary>

This is the full domain and subdomain name that will be used to access this instance from the internet, as well as the server's local IP address if you want OwnCloud to be accessible locally. They must be comma separated.

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

</details><details id="bkmrk-owncloud_domain-this"><summary>OWNCLOUD\_DOMAIN</summary>

This is the full domain and subdomain name that will be used to access this instance from the internet.

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

</details><details id="bkmrk-owncloud_admin_usern"><summary>OWNCLOUD\_ADMIN\_USERNAME</summary>

This is the username for the administrator account that will be used to log-in through the web interface.

<p class="callout success">*This should be an easy-to-remember user name.*</p>

</details>### Database

<details id="bkmrk-db_username-this-is-"><summary>DB\_USERNAME</summary>

This is the username to be used for logging into the database.

<p class="callout info">*For example:* owncloud\_admin</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-db_root_pass-this-is"><summary>DB\_ROOT\_PASS</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:

```
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><details id="bkmrk-db_user_pass-this-is"><summary>DB\_USER\_PASS</summary>

This is the password that will be used for user 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:

```
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><details id="bkmrk-owncloud_admin_passw"><summary>OWNCLOUD\_ADMIN\_PASSWORD</summary>

This is the password for the administrator account that will be used within the web interface.

<p class="callout warning">It is important to use secure passphrase that is easy-to-remember.</p>

</details>