Configuration of beCPG

Most of the configuration is included in the container, which must be rebuilt to deploy it. However, you can override the default configuration by editing the docker-compose.override.yml file.

The service name can be changed in the .env file and must match the DNS and SSL certificate:

SERVICE_NAME=inst1.becpg.fr

You can change the memory allocated to services in:

vi /opt/becpg-srv-instances/inst1/docker-compose.override.yml 

CATALINA_OPTS
* -Xmx6G to -Xmx8G for example

SSL configuration

SSL certificates are stored under /opt/becpg-srv-instances/inst1/ssl/. To update certificates, upload your new certificates with the same name to this folder and restart the service.

cd /opt/becpg-srv-instances/inst1
mv ./ssl/$SERVICE_NAME.crt ./ssl/$SERVICE_NAME.cert.old
cp new-cert.crt ./ssl/$SERVICE_NAME.crt
docker compose restart http

In some installations, the SSL certificate paths are different and can be changed in /opt/becpg-srv-instances/inst1/ssl/000-default.conf.

Sample command to generate an SSL key:

openssl req -nodes -newkey rsa:2048 -keyout $SERVICE_NAME.key -out $SERVICE_NAME.csr

Send the CSR to a certification authority to generate a valid certificate.

Extending beCPG

First, create a new config folder:

cd /opt/becpg-srv-instances/inst1
mkdir config

Then edit the docker-compose.override.yml file:

vi /opt/becpg-srv-instances/inst1/docker-compose.override.yml

And add a volume declaration under the becpg: section:

volumes:
- ./config/becpg-config-custom.xml:/usr/local/tomcat/shared/classes/alfresco/web-extension/becpg-config-custom.xml:ro

Create your becpg-config-custom.xml file:

touch config/becpg-config-custom.xml

And paste this text into it:

<alfresco-config>
        <config evaluator="string-compare" condition="wizard" replace="true">
                <!-- Your code -->
        </config>
</alfresco-config>

All configuration files can be overridden this way. Restart the service to apply the new configuration.

docker compose up -d