Configuring the Tanzu Application Platform GUI database

The Tanzu Application Platform GUI catalog allows for two approaches for storing catalog information:

  • In-memory database: The default option uses an in-memory database and is suitable for test and development scenarios only. The in-memory database reads the catalog data from Git URLs that you write in tap-values.yaml.

    This data is temporary. Any operations that cause the server pod in the tap-gui namespace to be re-created also cause this data to be rebuilt from the Git location.

    This can cause issues when you manually register entities by using the UI because they only exist in the database and are lost when that in-memory database is rebuilt. If you choose this method, you lose all user preferences and any manually registered entities when the Tanzu Application Platform GUI server pod is re-created.

  • PostgreSQL database: For production use-cases, use a PostgreSQL database that exists outside the Tanzu Application Platform packaging. The PostgreSQL database stores all the catalog data persistently both from the Git locations and the UI manual entity registrations.

For production or general-purpose use-cases, VMware recommends using a PostgreSQL database.

Configure a PostgreSQL database

To use a PostgreSQL database:

  1. Use the following values in tap-values.yaml:

          baseUrl: http://tap-gui.INGRESS-DOMAIN
            origin: http://tap-gui.INGRESS-DOMAIN
        # Existing tap-values.yaml above
            client: pg
              host: PG-SQL-HOSTNAME
              port: 5432
              user: PG-SQL-USERNAME
              password: PG-SQL-PASSWORD
              ssl: {rejectUnauthorized: false} # Set to true if using SSL


    • PG-SQL-HOSTNAME is the host name of your PostgreSQL database.
    • PG-SQL-USERNAME is the user name of your PostgreSQL database.
    • PG-SQL-PASSWORD is the password of your PostgreSQL database.
  2. Update the package profile by running:

    tanzu package installed update  tap --package-name --version VERSION-NUMBER --values-file tap-values.yaml -n tap-install

    Where VERSION-NUMBER is your Tanzu Application Platform version. For example, 1.1.0.

    For example:

    $ tanzu package installed update  tap --package-name --version 1.1.0 --values-file tap-values.yaml -n tap-install
    | Updating package 'tap'
    | Getting package install for 'tap'
    | Getting package metadata for ''
    | Updating secret 'tap-tap-install-values'
    | Updating package install for 'tap'
    / Waiting for 'PackageInstall' reconciliation for 'tap'
    Updated package install 'tap' in namespace 'tap-install'
check-circle-line exclamation-circle-line close-line
Scroll to top icon