The ocis init Command
When setting up Infinite Scale, the ocis init command can be used for basic configuration but is not suitable for all environments. This document describes the details.
In general, the ocis init command initializes ocis for the first run and creates an
ocis.yaml configuration file. See Configuration Rules for the file location. This command is helpful if you do not provide the necessary settings manually, but some rules apply.
When using the Binary Setup, the command is recommended to be run manually once before first usage, though you can also fully configure the initial setup manually.
The following command line parameters or their equivalent environment variables can be defined to configure the
ocis initcommand. When using environment variables the following structure is used; multiple variables are allowed:
<variable1>=<value1> \ <variable2>=<value2> \ ... ocis init
ocis init, a random admin password will be printed to the shell for first login. Though the password can be changed afterwards in the UI, it is possible to define it right from the start when initializing.
This allows to use transport security, but disables certificate verification. Useful with self-signed certificates to avoid certificate warnings. If set, the value will also be written to the config file. In such a case, when calling
ocis server, it is not necessary to set the environment variable again with each start.
Manually set the config directory to deviate from the default.
If using this setting, the environment variable MUST be used when starting
If you already have run
ocis initand a config has been defined, a consecutive run will cause a warning that a config already exists. Use this if you want to create a new configuration.
When setting this environment variable, the existing configuration will get overwritten and the existing installation and its data is no longer accessible. The use is intended for development purposes only.
When using the Container Setup, the command runs automatically when starting the container and no configuration file can be found. It skips the initialization step if an
ocis.yaml config file was found.
When using Container Orchestration like with Docker Compose or Kubernetes with Helm Charts, the
ocis init command MUST NOT be used and all configuration parameters must be handed over either via environment variables and/or via the Helm Chart / yaml files. Use the provided Helm Charts as your configuration base and adjust for Docker Compose as needed.
When Not to Use
Whenever there is a change in the existing configuration, independent of whether
ocis init was run before,
ocis init will:
fail if it finds an existing
not update any existing configuration.
overwrite an existing configuration when using the
--force-overwritecommand option - which is intended for development purposes only. For a brief overview see the ocis init description in the General Information documentation.
How to Apply Changes
If changes are necessary after running
ocis init, these changes must be applied via environment variables and/or yaml files to take effect.
To see which configurations are available, see the services descriptions.