cells configure

Setup required configurations

Synopsis

DESCRIPTION

Launch the configuration process of Pydio Cells.

REQUIREMENTS

You must have an available MySQL database, along with a privileged user (for instance 'pydio'). Supported databases are: - MariaDB version 10.3 and above, - MySQL version 5.7 and above (except 8.0.22 that has a bug preventing Cells to run correctly).

As recommended by database documentation, tune the 'max_connections' parameter to a value in line with your production database server specifications. For reference, the default value of 151 will have a maximum memory usage of about 575MB, but will not scale up for a multiple users load in production.

BROWSER-BASED INSTALLER

If you are on a desktop machine, pick browser-based installation at first prompt, or you can force it with: $ ./cells configure --bind default

The installer opens a web page on port 8080 with a wizard for you to provide various configuration parameters, including DB connection info and the login/password of the main administrator.

In case where default port is busy, you can choose another one via the 'bind' flag, for instance: $ ./cells configure --bind 0.0.0.0:12345 or
$ ./cells configure --bind :12345

After browser configuration, all microservices are started automatically and you can directly start using Cells. It is yet good practice to stop the installer and restart Cells in normal mode before going live.

COMMAND-LINE INSTALLER

If you are more a shell person, you can perform the configuration process directly using this CLI (using the '--cli' flag or by choosing so at first prompt). You will then be able to choose to either use the default bindings for the embedded webserver or adapt these to your specific setup.

You can always reconfigure the webserver bindings afterwards by calling this command: $ ./cells configure sites See corresponding inline documentation for further details.

AUTOMATED PROVISIONING

For automated, non-interactive installation, you can pass a YAML or a JSON config file that contains all necessary information, please refer to the documentation on https://pydio.com

ENVIRONMENT

All the command flags documented below are mapped to their associated ENV var using upper case and CELLS_ prefix. For example : $ ./cells configure --bind :9876 is equivalent to $ export CELLS_BIND=":9876"; ./cells configure

For backward compatibility reasons, the --cli, --yaml and --json flags do not respect the above rule (this might evolve in a future version). They are respectively equivalent to CELLS_INSTALL_CLI, CELLS_INSTALL_YAML and CELLS_INSTALL_JSON ENV vars.

./cells configure [flags]

Options

      --bind_address string         Address on which servers will bind. Binding port depends on the server type (grpc, http, etc). (default "127.0.0.1")
      --cli                         Do not prompt for install mode, use CLI mode by default
      --exit_after_install          Simply exits main process after the installation is done
  -h, --help                        help for configure
      --json string                 Points toward a configuration in JSON format
      --site_bind string            [Site] The 'site_' flags suite overrides config-defined sites. Bind is the site binding address IP|DOMAIN:PORT (default 0.0.0.0:8080)
      --site_external string        [Site] External full URL http[s]://IP|DOMAIN[:PORT] exposed to the outside
      --site_le_agree               [Site] Accept Let's Encrypt EULA
      --site_le_email string        [Site] Set email to enable Let's Encrypt automatic TLS configuration
      --site_le_staging             [Site] Use Let's Encrypt staging CA instead of production to avoid being banned on misconfiguration.
      --site_no_tls                 [Site] Use plain HTTP (default false, use self-signed)
      --site_tls_cert_file string   [Site] Path to custom TLS certificate file
      --site_tls_key_file string    [Site] Path to custom TLS key file
      --yaml string                 Points toward a configuration in YAML format

Options inherited from parent commands

      --config string   Configuration storage URL. Supported schemes: etcd|etcd+tls|file|grpc|mem|vault|vaults (default "file:///home/teamcity/.config/pydio/cells/pydio.json")

SEE ALSO

Auto generated by Pydio Cells Home Edition v4.4.3 on 17-Jun-2024
Back to top