Customizing Configuration¶

Note

Make sure that you understand the changes you are making. Improper PHP-FPM, PostgreSQL, or Docker configuration may cause issues.

You can customize the PHP-FPM and/or PostgreSQL settings for the API container. These settings will persist across container restarts, product updates, and other system changes.

Customize the PHP-FPM settings¶

To customize the PHP-FPM settings for the API container, edit the following file: /usr/local/solus/config/api-php-fpm.conf

Note

The file /usr/local/solus/config/api-php-fpm.conf must not be empty. An empty file will result in errors. By default, the file is populated with empty sections to prevent this.

Customize the PostgreSQL settings¶

To customize the PostgreSQL settings for the API container, edit the following file: /usr/local/solus/config/postgresql_custom.conf

Note

The file /usr/local/solus/config/postgresql_custom.conf can be empty.

Customize the stack.yml settings¶

To customize the stack.yml settings for the Solus management stack, edit the following file: /usr/local/solus/config/stack-override.yml

The following example shows how to configure the stack-override.yml file to increase the limits for the rabbitmq service:

version: '3.7'
services:
  rabbitmq:
    ulimits:
      nofile:
        soft: 65536

Note

Errors in the stack-override.yml file will cause the Management Node to fail during updates or reconfiguration. Use caution when editing this file.

Complete your customizations¶

After making any of the above customization changes, run the following command to apply the changes: /usr/local/solus/bin/installer -reconfigure

Note

Running /usr/local/solus/bin/installer -reconfigure will cause a brief downtime of the management server as it recreates the Docker containers.