[Contributing FAQ] How do I run MinIO locally on my computer (as a standalone as opposed to running it on a pod)?

[dsu-igeek]

How do I run MinIO locally on my computer (as a standalone as opposed to running it on a pod)?

[dsu-igeek]

This would be an alternative to setting up MinIO to run as a deployment in a Kubernetes cluster (we have instructions for that here: https://velero.io/docs/main/contributions/minio/).

Instructions to run standalone MinIO on Docker: https://docs.minio.io/docs/minio-docker-quickstart-guide

To create a MinIO container with persistent storage for GNU/Linux and macOS:

❯ docker run -p 9000:9000 \
    --name minio1 \
    -v /private/mnt/data:/data \
    -e "MINIO_ACCESS_KEY=minio" \
    -e "MINIO_SECRET_KEY=minio123" \
    minio/minio server /data

Note: you probably will need to create this directory structure and make sure it has write permission: /private/mnt/data. Here's some context for that: https://stackoverflow.com/questions/45122459/docker-mounts-denied-the-paths-are-not-shared-from-os-x-and-are-not-known/45123074.

Once the command above runs successfully, you can ctrl exit out of that and going forward run docker start/stop minio1 to bring the container up and down.

Whatever values you use above for MINIO_ACCESS_KEY and MINIO_SECRET_KEY are the credential values you will use to access this installation of MinIO.

Connecting Velero to the standalone MinIO:

When configuring a backup storage location, either via velero install or via velero create backup-location, the configuration should look like this:
--backup-location-config region=minio,s3ForcePathStyle="true",s3Url=http://192.168.2.49:9000

Note that the IP number needs to be the IP address of your machine (localhost will not work). You may get that address running ipconfig getifaddr en0.