dataset/seed/nextcloud/README.md

Table of Contents

• nextcloud
• Synopsis
• Example
• Basic variables
• General
• Reverse proxy
• Clients configuration
• Nextcloud
• Variables
• General
• OpenLDAP directory
• Client
• Reverse proxy
• Clients configuration
• OAuth2 client
• external
• Variables for expert
• General
• PHP
• Apache
• Requirements services
• Mandatories
• Optionals
• Dependances

Return to the list of application services.

nextcloud

Synopsis

Nextcloud, Online collaboration platform.

Example

Zone names are provided as examples. Think about adapting with the value of provider_zone in configuration file.

nextcloud:
  applicationservice: nextcloud
  zones_name:
    - ldap
    - localdns
    - oauth2
    - postgresql
    - redis
    - reverseproxy
    - smtp
  values:
    general.revprox.revprox_client.revprox_client_external_domainnames:
      - service.example.net
    general.nextcloud.nextcloud_mail_admin: admin@example.net

Basic variables

General

Reverse proxy

Clients configuration

This family is a leadership.

Parameter	Comment
general.revprox.revprox_client.revprox_client_external_domainnames mandatory, multiple Type: domainname	Service external domain name. Example: service.example.net
general.revprox.revprox_client.revprox_client_location mandatory Type: filename	URI to route request to the correct service. Default: /

Nextcloud

Parameter	Comments
general.nextcloud.nextcloud_mail_admin mandatory Type: mail	The administrator email. Example: admin@example.net

Variables

General

OpenLDAP directory

Client

Parameter	Comment
general.ldap.client.ldapclient_family Type: unix_user	Restrict service configuration for a LDAP family. "all" for all families.

Reverse proxy

Clients configuration

This family is a leadership.

Parameter	Comment
general.revprox.revprox_client.revprox_client_max_body_size Type: string	The maximum allowed size of the client request body.

OAuth2 client

Parameter	Comment
general.oauth2_client.oauth2_client_name mandatory Type: string	OAuth2 client name. Default: Collaboration Example: example
general.oauth2_client.oauth2_client_description mandatory Type: string	OAuth2 client description. Default: Plateforme de collaboration Nextcloud Example: Example description
general.oauth2_client.oauth2_client_login Type: web_address	OAuth2 URL to valid login.

external

Parameter	Comments
general.oauth2_client.external.oauth2_client_external mandatory, multiple Type: web_address	OAuth2 client external. Default: calculated
general.oauth2_client.external.oauth2_client_family mandatory Type: string	OAuth2 family. Default: users

Parameter	Comment
general.oauth2_client.oauth2_client_category mandatory Type: string	OAuth2 category. Default: Diffusion
general.oauth2_client.oauth2_client_logo mandatory Type: string	OAuth2 logo. Default: silique_folder.png

Variables for expert

General

PHP

Paramètrage avancé de PHP.

Parameter	Comment
general.php.php_post_max_size mandatory Type: number	Maximum size of POST data that PHP will accept. Value in Mb. Default: 32
general.php.php_upload_max_filesize mandatory Type: number	Maximum allowed size for uploaded files. Value in Mb. Default: 16
general.php.php_max_execution_time mandatory Type: number	Maximum amount of time each script may spend parsing request data. Value in seconds. Default: 30
general.php.php_max_input_time mandatory Type: number	Maximum amount of time each script may spend parsing request data. Value in seconds. Default: 60
general.php.php_memory_limit mandatory Type: number	Maximum amount of memory a script may consume. Value in Mb. Default: 512
general.php.php_session_gc_maxlifetime mandatory Type: number	Data will be seen as 'garbage' and potentially cleaned up after this delay. Value in seconds. Default: 3600

Apache

Advance Apache web server settings.

Parameter	Comment
general.apache.apache_timeout mandatory Type: number	Amount of time the server will wait for certain events before failing a request. Time in seconds. Default: 300
general.apache.apache_keepalive mandatory Type: boolean	Enables HTTP persistent connections. Default: True

Requirements services

Mandatories

• LocalDNS: DNS forwarder for local domain name.
• SMTP: Create a SMTP relay account and authorize sending email.
• LDAP: Create account and connexion to a LDAP server.
• ReverseProxy: Register to service to a reverse proxy server.
• Postgresql: Create account and connexion to a PostgreSQL server.
• OAuth2: Remote clients needing to verify OAuth2 account.
• Redis: Create account and connexion to a Redis server.

Optionals

• Journald: Concentrate journal messages on one host.

Dependances

• base-fedora-36: Base information of a Fedora 36.
  • base-fedora: Base information of a Fedora.
    • systemd: Systemd, a system and service manager.
      • base-machine: Base information for a machine.
        • base: Base of all application services.
        • dns-local: DNS client with access to local zones.
        • pki-tls: Autosign PKI or Let's encrypt support for TLS certificates.
      • journald: Journald.
      • resolved: Resolved.
• postgresql-client: Application service needs interact with a Postgresql server.
• ldap-client: Application service needs interact with a LDAP server.
• redis-client: Application service needs interact with a Redis server.
  • redis-common: Redis, an in-memory data structure store.
• oauth2-client: Application service needs interact with a Oauth2 server.
• relay-mail-client: Client SMTP.
• apache: Apache as web server.
  • reverse-proxy-client: Application service needs interact with a a reverse proxy server.
• php-fpm: PHP FPM.
  • php: PHP, a popular general-purpose scripting language.