Image Artist: Using a custom storage mountpoint for MinIO

Important Note

The following workflows apply only to new Image Artist installations for setting a custom storage location. 

If you change the storage mount point for an existing installation, you must also account for data migration to avoid data loss or service disruption.

Default Storage Location

By default, Image Artist is configured so that the MinIO server stores its payload in a Docker named volume. These volumes are managed by the Docker daemon and are located under /var/lib/docker/volumes on the Image Artist host.

Because the MinIO volume can grow very large (potentially exceeding 100 TB), it is often more appropriate to store this volume on a separate disk or mount point.

Custom Storage Location

If a custom storage location is required, the configuration must be modified as described in the relevant section below.

Image Artist v1.4

By default, MinIO uses the following Docker storage volume: minio_user_data_new_fs

This volume is located at: /var/lib/docker/volumes/SImA_minio_user_data_new_fs

To use a custom location for MinIO data:

1. Open the .env file (a hidden file) in the Image Artist installation directory.
2. Locate the variable: MINIO_VOLUME_PATH_NEW_FS

3. Replace its value with your desired path. For example:

   MINIO_VOLUME_PATH_NEW_FS=/path/to/minio/data

The new path will take effect the next time you redeploy the Image Artist stack.

Image Artist v1.3

By default, MinIO uses the following Docker storage volume: minio_user_data

This volume is located at: /var/lib/docker/volumes/SImA_minio_user_data

To use a custom location for MinIO data:

1. Open the .env file (a hidden file) in the Image Artist installation directory.
2. Locate the variable: MINIO_VOLUME_PATH

3. Replace its value with your desired path. For example: 

   MINIO_VOLUME_PATH=/path/to/minio/data

The new path will take effect the next time you redeploy the Image Artist stack.

Image Artist v1.2

By default, MinIO uses the following Docker storage volume: minio1_data

This volume is located at: /var/lib/docker/volumes/SImA_minio1_data

To use a custom location for MinIO data:

1. Open the .env file (a hidden file) in the Image Artist installation directory.
2. Locate the variable: MINIO_VOLUME_PATH

3. Replace its value with your desired path. For example: 

   MINIO_VOLUME_PATH=/path/to/minio/data

The new path will take effect the next time you redeploy the Image Artist stack.

Image Artist v1.1 or below

The MinIO volume mountpoint is defined in the docker-compose.yml file located in the Image Artist installation directory. This configuration is part of the minio1 service mapping.

Below is an example snippet from docker-compose.yml:

01   minio1:
02     <<: *service-base
03     image: minio-server
04     build:
05       context: ./minio
06       dockerfile: Dockerfile.server
07     entrypoint: sh
08     command: [/scripts/minio_server_entrypoint.sh, /data1]
09     env_file: default.env
10     volumes:
11       - minio1_data:/data1

Line 11 maps the Docker named volume minio1_data to the container path /data1.

To store MinIO data in a custom location, replace the named volume with your desired host path.

Example:
If you want MinIO data stored under /path/to/minio/data, update line 11 as follows:

10     volumes:
11       - /path/to/minio/data:/data1