Skip to main content
In this guide, you’ll learn how to customize chart parameters during installation with Helm. By default, when installing WordPress using the Bitnami Helm chart, the deployment leverages the default settings provided in its values.yaml file. For example, executing the command below:
will deploy WordPress with the blog name set to “User’s Blog!” since that is the value defined in the values.yaml file. The chart automatically configures these defaults as environment variables for the application.

Using the Command Line to Override Defaults

Sometimes you may want to change specific default settings like the blog name or email address. Rather than modifying the values.yaml file directly, you can use the --set option on the command line to override these values. For instance, to change the blog name, run:
You can chain multiple --set options to override any parameter from the default configuration. Below is an excerpt from the default values for reference:
The parameters passed on the command line will take precedence over the default values specified in the file.

Using a Custom Values File

For scenarios where multiple settings need to be overridden, it may be more efficient to create your own custom values file. Follow these steps:
  1. Create a file named custom-values.yaml with your desired configuration:
  2. Install the chart with your custom values file using the following command:
This approach directs Helm to load your custom settings, thereby overriding those defined in the default values.yaml file.

Modifying the Built-in values.yaml Directly

For a more permanent configuration change, you might choose to modify the chart’s built-in values.yaml file. To do this, you first need to pull the chart locally. Begin by downloading the chart archive:
You can then extract the files using one of two methods:
  • Unarchive the file manually
  • Use the --untar option:
After extracting, you will find a directory (named wordpress) containing all chart files, including values.yaml. Here is a sample view of its contents:
Modify the file using any text editor to adjust the desired values. When ready, install the modified chart locally by specifying the chart directory:
Below is an example of how your customized local values.yaml file might appear:
When installing from a local chart directory, the Helm installation command accepts both a repository chart name or a file path.

Summary

In this article, we explored three effective methods to customize your WordPress deployment using Helm:
  1. Overriding default values with command line parameters using the --set option.
  2. Employing a custom values file via the --values option.
  3. Modifying the built-in values.yaml file by pulling and editing the chart locally.
Each method is designed to tailor the deployment to meet your specific configuration requirements, ensuring that the installation aligns perfectly with your environment. For more detailed information and additional practices, refer to the official Helm Documentation.

Watch Video

Practice Lab