diff --git a/php/templates/containers.twig b/php/templates/containers.twig index fd750256..117b1a42 100644 --- a/php/templates/containers.twig +++ b/php/templates/containers.twig @@ -63,19 +63,19 @@ {% if is_daily_backup_running == true %} Daily backup currently running. (Logs)

{% if automatic_updates == true %} - It will update your containers, the mastercontainer and on saturdays your Nextcloud apps if the backup is successful.

+ This will update your containers, the mastercontainer and, on Saturdays, your Nextcloud apps if the backup is successful.

{% if is_mastercontainer_update_available == true %} - Since the mastercontainer gets updated, it will restart the container which will make it unavailable for a moment. (Logs)

+ When the mastercontainer is updated it will restart the container, making it unavailable for a moment. (Logs)

{% endif %} {% endif %} {% if has_update_available == false %} The whole process should not take more than a few minutes.

{% elseif automatic_updates == true %} - The whole process can take a while because your containers get updated.

+ The whole process can take a while as your containers will be updated.

{% endif %} Reload ↻
{% elseif isWatchtowerRunning == true %} - Mastercontainer update currently running. It will restart the mastercontainer soon which will make it unavailable for a moment. Please wait until that's done. (Logs)

+ Mastercontainer update currently running. Once the update is complete the mastercontainer will restart, making it unavailable for a moment. Please wait until it's done. (Logs)

Reload ↻
{% else %} {% if is_backup_container_running == false and domain == "" %} @@ -101,9 +101,9 @@ {% else %} AIO is currently in "reverse proxy mode" which means that it can be installed behind a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else) and does not do the TLS proxying itself.

{% endif %} - Please type in the domain into the input field below that will be used for Nextcloud in order to create a new AIO instance.

+ Please type the domain that will be used for Nextcloud below in order to create a new AIO instance.

{% if skip_domain_validation == true %} - Please note: The domain validation is disabled so any domain will be accepted here! So make sure that you do not make a typo here as you will not be able to change it afterwards!

+ Please note: The domain validation is disabled so any domain will be accepted here! Make sure you do not make a typo here as you will not be able to change it afterwards!

{% endif %}
@@ -112,15 +112,15 @@
{% if skip_domain_validation == false %} - Make sure that this server is reachable on port 443 (port 443/tcp is open/forwarded in your firewall/router and 443/udp as well if you want to enable http3) and that you've correctly set up the DNS config for the domain that you enter (set the A record to your public ipv4-address and if you need ipv6, set the AAAA record to your public ipv6-address. A CNAME record if of course also possible). You should see hints on what went wrong if your domain does not get accepted in the top right corner.

+ Make sure that this server is reachable on port 443 (port 443/tcp is open/forwarded in your firewall/router and 443/udp as well if you want to enable http3) and that you've correctly set up the DNS config for the domain that you enter (set the A record to your public ipv4-address and if you need ipv6, set the AAAA record to your public ipv6-address. A CNAME record if of course also possible). You should see hints on what went wrong in the top right corner if your domain is not accepted.

Click here for further hints
- If you should not have a domain yet, you can get one for free e.g. from duckdns.org and others.

+ If you do not have a domain yet, you can get one for free e.g. from duckdns.org and others.

If you have a dynamic public IP-address, you can use e.g. DDclient with a compatible domain provider for DNS updates.

If you only want to install AIO locally without exposing it to the public internet or if you cannot do so, feel free to follow this documentation.

If you should be using Cloudflare Proxy for your domain, make sure to disable the Proxy feature temporarily as it might block the domain validation attempts.

{% if apache_port != '443' %} - If you run into issues getting your domain accepted, see these steps for how to debug things.

+ If you run into issues with your domain being accepted, see these steps for how to debug things.

{% endif %} Hint: If the domain validation fails but you are completely sure that you've configured everything correctly, you may skip the domain validation by following this documentation.
@@ -159,7 +159,7 @@
{% endif %} - Choose the backup that you want to restore and click on the button below to restore the selected backup. This will restore the whole AIO instance from backup. Please note that the current AIO passphrase will be kept and the previous AIO passphrase will not be restored from backup!

+ Choose the backup that you want to restore and click on the button below to restore the selected backup. This will restore the whole AIO instance. Please note that the current AIO passphrase will be kept and the previous AIO passphrase will not be restored from backup!

@@ -174,7 +174,7 @@ {% elseif borg_backup_mode == 'restore' %} {% if backup_exit_code > 0 %} Last restore failed! (Logs)

- Somehow the restore failed which is unexpected! Please adjust the path and encryption password, test it and try to restore again! + The restore process has unexpectedly failed! Please adjust the path and encryption password, test it and try to restore again! {% endif %} {% endif %} {% endif %} @@ -189,7 +189,7 @@
{{ include('includes/backup-dirs.twig') }} - ⚠️ Please note that the backup archive must be located in a subfolder of the folder that you enter here and the subfolder which contains the archive must be named 'borg'. Otherwise will the backup container not find the backup archive!

+ ⚠️ Please note that the backup archive must be located in a subfolder of the folder that you enter here and the subfolder which contains the archive must be named 'borg', or the backup container will not be able to find the backup archive!

{% endif %} {% else %} Everything set! Click on the button below to test the path and encryption password:

@@ -239,8 +239,8 @@ Containers are currently starting. You might inspect the container logs by clicking on
Starting
next to each container for further details.

Reload ↻

{% else %} - It seems like at least one container is currently restarting which means it is not able to start correctly.

- To break out this endless loop, you can stop the containers below and investigate the issue by having a look at the container logs before starting them again.

+ It seems at least one container was not able to start correctly and is currently restarting.

+ To break this endless loop, you can stop the containers below and investigate the issue in the container logs before starting the containers again.

@@ -308,7 +308,7 @@ {% if isAnyRunning == true %} {% if isApacheStarting != true %} {% if is_mastercontainer_update_available == true %} - ⚠️ A mastercontainer update is available. Please click on the button below to stop your containers in order to be able to update the mastercontainer.

+ ⚠️ A mastercontainer update is available. Please click on the button below to stop your containers in order to update the mastercontainer.

{% if current_channel starts with 'latest' %} You can find the changelog here

{% elseif current_channel starts with 'beta' %} @@ -325,10 +325,10 @@ {% endif %} {% else %} {% if isBackupOrRestoreRunning == true %} - Restore or Backup currently running. Cannot start the containers until that's done.

+ Restore or Backup currently running. Cannot start the containers until Restore or Backup is complete.

{% else %} {% if was_start_button_clicked == false %} -
Clicking on the button below will download all docker containers and start them. This can take a lot of time depending on your internet connection. Since the overall size is a few GB, this will take around 5-10 min or more. So be aware and patient!

+
Clicking on the button below will download all docker containers and start them. This can take a long time depending on your internet connection. Since the overall size is a few GB, this can take around 5-10 min or more. Please be patient!

{% endif %} {% if is_mastercontainer_update_available == true %} ⚠️ A mastercontainer update is available. Please click on the button below to update it.

@@ -372,7 +372,7 @@ {% else %} {% if is_backup_container_running == false and borg_backup_host_location == "" and isApacheStarting != true %}

Backup and restore

- Please type in the directory where backups will get created on the host system below. In best case make sure that you choose a location on a separate drive and not on your root drive.

+ Please enter the directory path below where backups will be created on the host system. It's best to choose a location on a separate drive and not on your root drive.

@@ -391,7 +391,7 @@ {% if backup_exit_code > 0 %} Last {{ borg_backup_mode }} failed! (Logs)

{% if borg_backup_mode == "check" %} - The backup check was not successful which might points towards a corrupt archive (look at the logs). If that should be the case, you can try to fix it by following this documentation

+ The backup check was not successful. This might indicate a corrupt archive (look at the logs). If that should be the case, you can try to fix it by following this documentation

Reveal repair option
Below is the option to repair the integrity of your backup. Please note: Please only use this after you have read the documentation above! (It will run the command 'borg check --repair' for you.)

@@ -403,7 +403,7 @@

{% endif %} {% if has_backup_run_once == false %} - You may change the backup path again since the initial backup was not successful. After submitting the new value, you need to click on Create Backup for testing the new value.

+ You may change the backup path again since the initial backup was not successful. After submitting the new value, you need to click on Create Backup to test the new value.

@@ -423,18 +423,18 @@ {% if is_backup_container_running == false and isApacheStarting == false %} {% if has_backup_run_once == true %}
- Click here to reveal all backup options (it also includes an option for automatic updates)
+ Click here to reveal all backup options (including an option for automatic updates)
{% endif %}

Backup information

This is your encryption password for backups: {{ borgbackup_password }}

- Please save it at a safe place since you won't be able to restore from backup if you lose this password!

- All important data of your Nextcloud AIO instance will get backed up like the database, your files and configuration files of the mastercontainer and else.

- The backup itself uses a tool that is called BorgBackup which is a well-known server backup tool that efficiently backs up your files and encrypts them on the fly.

+ Please save this password in a safe place. You won't be able to restore from backup if you lose this password!

+ All important data from your Nextcloud AIO instance such as the database, your files and the mastercontainer's configuration files, will be backed up.

+ The backup uses a tool called BorgBackup, a well-known server backup tool that efficiently backs up your files and encrypts them on the fly.

By using this tool, backups are incremental, differential, compressed and encrypted – so only the first backup will take a while. Further backups should be fast as only changes are taken into account.

- Backups get created in the following directory on the host: {{ borg_backup_host_location }}/borg

- Be aware that this solution does not back up files and folders that are mounted into Nextcloud using the external storage app - but you can add further Docker volumes and host paths that you want to back up after the initial backup is done.

- Regarding backup retention, see this.

- Daily backups can get enabled after the initial backup is done. Enabling this also allows to enable an option that allows to update all containers, Nextcloud and its apps automatically.

+ Backups will be created in the following directory on the host: {{ borg_backup_host_location }}/borg

+ Be aware that this solution does not backup files and folders that are mounted into Nextcloud using the external storage app, but you can add further Docker volumes and host paths that you want to back up after the initial backup is done.

+ For information about backup retention, see this.

+ Daily backups can be enabled after the initial backup is done. Enabling this also allows you to enable an option to update all containers, Nextcloud, and its apps automatically.

For further documentation and options on this backup solution refer to this section and below.
{% if isApacheStarting != true %} @@ -459,7 +459,7 @@ {% if has_backup_run_once == true %}

Backup check

- Click on the button below to perform a backup integrity check. This is an option that verifies that your backup is intact but it shouldn't be needed in most situations.

+ Click on the button below to perform a backup integrity check. This is an option that verifies that your backup is intact. It shouldn't be needed in most situations.

@@ -467,7 +467,7 @@

Backup restore

- Choose the backup that you want to restore and click on the button below to restore the selected backup. This will overwrite all your files with the state of the backup so you should consider creating a backup first. It also makes sense to run an integrity check before restoring your files but is not mandatory since it shouldn't be needed in most situations. Please note that this will not restore additionally chosen backup directories! The restore process should be pretty fast as rsync is used to restore the chosen backup which only transfers changed files and deletes additional ones.

+ Choose the backup that you want to restore and click on the button below to restore the selected backup. This will overwrite all your files with the chosen backup so you should consider creating a backup first. You can run an integrity check before restoring your files but this shouldn't be needed in most situations. Please note that this will not restore additionally chosen backup directories! The restore process should be pretty fast as rsync, which only transfers changed files, is used to restore the chosen backup.

@@ -481,7 +481,7 @@

Daily backup and automatic updates

{% if daily_backup_time == "" %} - By entering a time below, you can enable daily backups. It will create them at the entered time in 24h format. E.g. 04:00 will create backups at 4 am UTC and 16:00 at 4 pm UTC. For creating the backup, it will stop the containers and start them back up after the backup is done.

+ By entering a time below, you can enable daily backups. It will create them at the entered time in 24h format. E.g. 04:00 will create backups at 4 am UTC and 16:00 at 4 pm UTC. When creating the backup, containers will be stopped and restarted after the backup is complete.

@@ -491,11 +491,11 @@
{% else %} - Daily backups will be created at {{ daily_backup_time }} UTC which includes a notification about the result of the backup. + Daily backups will be created at {{ daily_backup_time }} UTC. A notification about the result of the backup will be sent. {% if automatic_updates == true %} - Also your containers, the mastercontainer and on saturdays your Nextcloud apps will be automatically updated. + Also your containers, the mastercontainer and, on Saturdays, your Nextcloud apps will be automatically updated. {% endif %} - To change your backup time, first disable Daily Backups and then re-enable them with your new backup time.

+ To change your backup time first disable Daily Backups, then enter your new backup time, and then re-enable them.

@@ -505,15 +505,15 @@ {% endif %}

Back up additional directories and docker volumes of your host

- Below, you can enter directories and docker volumes of your host that will backed up additionally into the same borg backup archive.

+ Below you can enter directories and docker volumes of your host that will be backed up into the same borg backup archive.


- Each line and entry needs to start with a slash or letter/digit. Allowed are only a-z, A-Z, ., 0-9, _, -, and /. If the entry begins with a letter/digit are slashes not supported. Two valid entries are /directory/on/the/host and my_custom_docker_volume. You need to make sure yourself that all given directories exist. Otherwise the backup container will fail starting!

- Make sure to specify all storages that you want to back up separately since storages will not be mounted recursively. E.g. providing / as additional backup directory will only back up files and folders that are stored on the root partition and not on the EFI partition or any other. Excluded by the backup will be caches and a few other directories. You should make sure to stop all services before the backup can run correctly if you want to back up the root partition. For automating this see this documentation

+ Each line and entry needs to start with a slash or letter/digit. Only a-z, A-Z, ., 0-9, _, -, and / are allowed. If the entry begins with a letter/digit slashes are not supported. Two valid entries are /directory/on/the/host and my_custom_docker_volume. You need to make sure that all given directories exist or the backup container will fail to start!

+ Be sure to individually specify all storage that you want to back up as storage will not be mounted recursively. E.g. providing / as additional backup directory will only back up files and folders that are stored on the root partition and not on the EFI partition or any other. Excluded by the backup will be caches and a few other directories. If you want to back up the root partition you should make sure to stop all services before the backup so it can run correctly. For automating this see this documentation

Please note that the chosen directories/volumes will not be restored when you restore your instance, so this would need to be done manually.

{% if additional_backup_directories != "" %} This option is currently set. You can disable it again by clearing the field and submitting your changes.

@@ -551,9 +551,9 @@

Optional containers

In this section you can enable or disable optional containers. There are further community containers available that are not listed below. See this documentation how to add them.

{% if isAnyRunning == true %} - Please note: You can enable or disable them when your containers are stopped.

+ Please note: You can enable or disable the options below only when your containers are stopped.

{% else %} - Please note: Make sure to save your changes by clicking on the button Save changes that is positioned below the list of optional containers. The changes will not be auto-saved.

+ Please note: Make sure to save your changes by clicking Save changes below the list of optional containers. The changes will not be auto-saved.

{% endif %}
@@ -647,17 +647,17 @@ Please note: You can change the timezone when your containers are stopped.

{% else %} {% if timezone == "" %} - In order to get the correct time values for certain Nextcloud features, it makes sense to set the timezone for Nextcloud to the one that your users mainly use. Please note that this setting does not apply to the mastercontainer and any backup option.

+ To get the correct time values for certain Nextcloud features, set the timezone for Nextcloud to the one that your users mainly use. Please note that this setting does not apply to the mastercontainer and any backup option.

You can configure the timezone for Nextcloud below:

- +
You need to make sure that the timezone that you enter is valid. An example is Europe/Berlin. You can get valid values by looking at the 'TZ identifier' column of this list: click here. The default is Etc/UTC if nothing is entered.

{% else %} - The timezone for Nextcloud is currently set to {{ timezone }}. You can reset the timezone again by clicking on the button below.

+ The timezone for Nextcloud is currently set to {{ timezone }}. You can change the timezone by clicking on the button below.