github.com/codefresh-io/kcfi@v0.0.0-20230301195427-c1578715cc46/docs/external-dbs/mongodb.md (about)

     1  # Configuring external MongoDB
     2  
     3  Codefresh recommends to use Bitnami MongoDB [chart](https://github.com/bitnami/charts/tree/master/bitnami/mongodb) as a Mongo database.
     4  
     5  To configure Codefresh on-premises to use external Mongo service one needs to provide the following values:
     6  
     7  - **mongo connection string** - `mongoURI`. This string will be used by all of the services to communicate with mongo. Codefresh will automatically create and add a user with "ReadWrite" permissions to all of the created databases with the username and password from the URI. Optionally, automatic user addition can be disabled - `mongoSkipUserCreation`, in order to use already existing user. In such a case the existing user must have **ReadWrite** permissions to all of newly created databases.  
     8  Codefresh does not support [DNS Seedlist Connection Format](https://docs.mongodb.com/manual/reference/connection-string/#connections-dns-seedlist) at the moment, use the [Standard Connection Format](https://docs.mongodb.com/manual/reference/connection-string/#connections-standard-connection-string-format) instead.
     9  - mongo **root user** name and **password** - `mongodbRootUser`, `mongodbRootPassword`. The privileged user will be used by Codefresh only during installation for seed jobs and for automatic user addition. After installation, credentials from the provided mongo URI will be used.  Mongo root user must have permissions to create users.
    10  
    11  > ToDo
    12  Even if `mongoSkipUserCreation` set to `true` and `mongoURI` contains root credentials, the `mongodbRootUser` and `mongodbRootPassword` should be set anyway because Mongo seed job expects them.
    13  We should fix it
    14  
    15  Here is an example of all the related values:
    16  
    17  ```yaml
    18  global:
    19    mongodbRootUser: <MONGO ROOT USER>
    20    mongodbRootPassword: <MONGO ROOT PASSWORD>
    21    mongoURI: <MONGO URI>
    22    mongoSkipUserCreation: true
    23    mongoDeploy: false   # disables deployment of internal mongo service
    24  
    25  mongo:
    26    enabled: false
    27   ```