OwnCloud (AlmaLinux 8)

Software included

Package	Version
OwnCloud	latest
Docker	3.20.10
Docker compose	2.12.2
containerd.io	1.6.10

Initial start of the service

This application uses Docker to provide faster startup of the companion software (OwnCloud) and direct use of it. This eliminates the need to familiarize yourself with its specifics in terms of configuration and installation. To start working directly with the application, all you need to do is visit the IP address assigned to your virtual machine in your browser to view your new OwnCloud installation.

Note: By default, OwnCloud can be accessed directly by IP address. To start using OwnCloud with your real domain, you must first point the domain in question to your IP address and change the settings for where OwnCloud opens from its admin panel.

Quick settings and frequently asked questions

• Logging into the cloud service is done using an SSH key or password that you have specified.
• Docker is installed as recommended by the official docker documentation.
• The standard docker and docker compose commands are now available in this application.
• When the virtual machine is first started, it takes a few minutes before a Docker container containing OwnCloud is started.
• OwnCloud data is set to be persistent and is located in /opt/owncloud/data/. MariaDB is also persistent and stores its databases in /opt/mariadb/data/.
• The user to access the OwnCloud admin panel is admin and the password is P@ssw0rd!.

Note: OWNCLOUD_HOST is set to be the first address of the virtual machine. The goal is to have access immediately after starting the machine. To start using OwnCloud with your real domain, you must first point the domain in question to your IP address and change the settings for where OwnCloud opens from its admin panel.

Additional Docker settings

Additional OwnCloud settings that you can change and that are controlled directly by Docker are set as variable values in the configuration file /opt/docker-owncloud/docker-compose.yml:

Note: After changing any of the values, you must recreate the Docker container on which the application is running. For more information, please read the Recreating Docker containers section.

OwnCloud configuration options

General options

• APACHE_HTTP_PORT_NUMBER: Port used by Apache for HTTP access inside the Docker container itself. Default: 8080
• APACHE_HTTPS_PORT_NUMBER: Port used by Apache for HTTPS access inside the Docker container itself. Default: 8443
• OWNCLOUD_USERNAME: ownCloud admin user. Default: admin
• OWNCLOUD_PASSWORD: ownCloud admin password. Default: P@ssw0rd!
• OWNCLOUD_EMAIL: ownCloud admin email. Default: admin@example.com
• OWNCLOUD_SKIP_BOOTSTRAP: Whether to skip initial bootstrapping of OwnCloud. Default: no
• OWNCLOUD_HOST: ownCloud host for configuring internal paths. Default: the current IP address of the machine

Configuration with already existing databases

• OWNCLOUD_DATABASE_TYPE: Database type. Valid values: mysql, sqlite. Default: mysql
• OWNCLOUD_DATABASE_HOST: Hostname for connection with MariaDB or MySQL server. Default: mariadb
• OWNCLOUD_DATABASE_PORT_NUMBER: Port for connection with MariaDB or MySQL server. Default: 3306
• OWNCLOUD_DATABASE_NAME: Database name that OwnCloud will use to connect to the MariaDB or MySQL server. Default: bitnami_owncloud
• OWNCLOUD_DATABASE_USER: User that OwnCloud will use to connect to the MariaDB or MySQL server. Default: bn_owncloud
• OWNCLOUD_DATABASE_PASSWORD: Database password that OwnCloud will use to connect to the MariaDB or MySQL server. No defaults.
• ALLOW_EMPTY_PASSWORD: Used to connect to the database with empty passwords. Default: no

SMTP configuration options

• OWNCLOUD_SMTP_HOST: SMTP host.
• OWNCLOUD_SMTP_PORT: SMTP port.
• OWNCLOUD_SMTP_USER: SMTP user.
• OWNCLOUD_SMTP_PASSWORD: SMTP password.
• SUITECRM_SMTP_PROTOCOL: SMTP protocol.

PHP configuration options

• PHP_ENABLE_OPCACHE: Enable OPcache for PHP. Default: yes
• PHP_EXPOSE_PHP: Display HTTP header in PHP. No default.
• PHP_MAX_EXECUTION_TIME: Maximum execution time of PHP scripts. No default.
• PHP_MAX_INPUT_TIME: Maximum input time for PHP scripts. No default.
• PHP_MAX_INPUT_VARS: Maximum number of variables in PHP scripts. No default.
• PHP_MEMORY_LIMIT: Memory limit for PHP scripts. Default: 512M
• PHP_POST_MAX_SIZE: Maximum size of PHP POST requests. No default.
• PHP_UPLOAD_MAX_FILESIZE: Maximum file upload size for PHP scripts. No default.

Working with Docker

The organization of this application is entirely done using Docker. In this way, we can provide you with ready-made applications faster. In addition, their configuration is more flexible and quite controllable. To be able to control this application, however, you need to know some basic Docker functionalities and features.

Restarting all services

Restarting the database and the Docker container that contains OwnCloud itself, along with the rest of the software, can be done in two ways:

1. By restarting the entire virtual machine
2. Restarting the Docker containers, which is the faster option. To do this, access your machine via SSH, and run the following commands:

sudo su -
cd /opt/docker-owncloud/
docker compose restart

Recreating Docker containers

Recreation of a docker container may be necessary if you've changed the configuration inside the docker-compose.yml file. If there are changes, please follow these steps:

cd /opt/docker-owncloud/
docker compose stop
docker compose up -d

Checking the status of the Docker application

To check, you need to run the following commands:

sudo su -
docker ps -a

Please pay attention to the STATUS column. It should show how long the service has been running, for example Up X minutes. If the status is Restarting then you need to check what is wrong with the application. In such a case, you can check by following the application logs as follows:

1. Get the application name that you can see in the NAMES column from the output of the docker ps -a command. View the logs with the docker logs <NAME> command, where is the name of the container.

Changing settings

The settings in section Additional Docker settings can be set in the docker-compose.yml file. The path to it is described again in this section. To change a setting, open the configuration file and note the environment section under owncloud. Each configuration option must be described on a new line with a dash in front, as in the following example:

    environment:
      - OWNCLOUD_USERNAME=admin
      - OWNCLOUD_PASSWORD=P@ssw0rd!

Please note that the correct indentation (number of spaces) must also be observed, as this is important for yaml configuration files.