Deploy MinIO AIStor as a Container

MinIO AIStor is licensed under the MinIO Software License. An active license is required for production deployments.

This section documents steps for running MinIO AIStor as a container.

Procedure

Pull the latest stable image of AIStor Server

docker pull quay.io/minio/aistor/minio

podman pull quay.io/minio/aistor/minio

Create the directory structure

Create directories for data and certificates. The following example uses $HOME/minio as the base path.
```
mkdir -p $HOME/minio/data $HOME/minio/certs
```
Later steps mount these directories to standard Linux paths in the container.
Retrieve your license file

MinIO AIStor requires a license to run. You can use an existing license, such as one from SUBNET, or you can request a new MinIO AIStor Free Tier license.

To request a new MinIO AIStor Free Tier license, go to the MinIO AIStor pricing page and select Get Started under the Free tier to obtain a free license. The free tier license allows you to run MinIO AIStor on a single compute resource with one or more drives.

Download the license file to $HOME/minio/minio.license for use in later steps.

Free tier licenses do not include support. For support options, see the MinIO AIStor pricing page. For more information about licenses, see Licenses.
(Optional) Set up TLS

If you need TLS for your deployment, configure it before starting the server. See Set up network encryption for instructions.

Run the AIStor Server in a container

The following examples mount the local directories to standard Linux paths in the container:

$HOME/minio/data to /mnt/data for object storage
$HOME/minio/minio.license to /minio.license for the license file
$HOME/minio/certs to /etc/minio/certs for TLS certificates (if configured)

docker run -dt                                             \
  -p 9000:9000 -p 9001:9001                                \
  -v $HOME/minio/data:/mnt/data                            \
  -v $HOME/minio/minio.license:/minio.license              \
  -v $HOME/minio/certs:/etc/minio/certs                    \
  --name "aistor-server"                                   \
  quay.io/minio/aistor/minio:latest minio server /mnt/data \
  --license /minio.license                                 \
  --certs-dir /etc/minio/certs

docker logs aistor-server

podman run -dt                                             \
  -p 9000:9000 -p 9001:9001                                \
  -v $HOME/minio/data:/mnt/data                            \
  -v $HOME/minio/minio.license:/minio.license              \
  -v $HOME/minio/certs:/etc/minio/certs                    \
  --name "aistor-server"                                   \
  quay.io/minio/aistor/minio:latest minio server /mnt/data \
  --license /minio.license                                 \
  --certs-dir /etc/minio/certs

podman logs aistor-server

The output of the logs command includes the startup message from the AIStor Server. To access the server, use the localhost or 127.0.0.1 address on your local host machine.

Install the AIStor Client (`mc`)

curl --progress-bar -L https://dl.min.io/aistor/mc/release/linux-amd64/mc -o mc
chmod +x ./mc

sudo mv ./mc /usr/local/bin/
mc --version

curl --progress-bar -L https://dl.min.io/aistor/mc/release/linux-arm64/mc -o mc
chmod +x ./mc

sudo mv ./mc /usr/local/bin
mc --version

Connect to the deployment

You can connect to the deployment using the built-in Console UI or the AIStor Client (mc).
Open your browser to http://localhost:9001.
Log in using the default minioadmin:minioadmin username and password.
1. Create a new alias for the MinIO AIStor server:
  mc alias set myaistor http://localhost:9000 minioadmin minioadmin
2. Create a bucket and copy a file to that bucket:
  mc mb myaistor/data mc cp ~/somefile.txt myaistor/data

Deploy MinIO AIStor as a Container

On this page