dataset/seed/nextcloud/README.md
2023-08-23 22:29:16 +02:00

15 KiB

Table of Contents

Return to the list of application services.

nextcloud

Synopsis

Nextcloud, Online collaboration platform.

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 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

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

Requirements services

Mandatories

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

Optionals

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

Dependances