Deploy AIStor as a Container

This section documents steps for running AIStor as a container.

1. Pull the latest stable image of AIStor Server

   Docker

   docker pull quay.io/minio/aistor/minio
   

   Podman

   podman pull quay.io/minio/aistor/minio
   

2. Create a data directory for use with the server

   The following example uses the path $HOME/minio/data. Change this path to reflect the folder, storage volume, or drive intended for use with the server.

   makedir -p $HOME/minio/data
   

   Later steps mount paths under $HOME/minio to the /mnt/ directory in the container.

3. Retrieve your License File.

   Log into SUBNET and select the License button in the Deployments view.

   

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

4. Create the environment file

   Create the following file at $HOME/minio/config. The server uses this file as the source of all environment variables.

   The following example provides the minimum set of configuration settings required to start the server using the default username and password minioadmin:minioadmin. The file paths given are local to the container.

   # Copy the value of your SUBNET license below
   MINIO_LICENSE="/mnt/minio/minio.license"
   # Define the expected topology of the deployment
   #
   # The following is a single-node single-drive deployment pattern
   # appropriate for workloads where distributed performance and 
   # high availability are not requirements.
   #
   # Single-Node Single-Drive Startup
   MINIO_VOLUMES="/mnt/minio/data"
   # Set all Server command-line options
   #
   # Use this envvar to add other CLI parameters to the `minio server` command.
   MINIO_OPTS=""
   
   MINIO_CONFIG_ENV_FILE="/mnt/minio/config"
   

5. Run the AIStor Server in a container

   The following examples mount the $HOME/minio/ folder to /mnt/minio in the container.

   Docker

   docker run -dt \
   -p 9000:9000 -p 9001:9001 \
   -v $HOME/minio:/mnt/minio \
   --name "aistor-server" \
   minio server
   
   docker logs aistor-server
   

   Podman

   podman run -dt \
   -p 9000:9000 -p 9001:9001 \
   -v $HOME/minio:/mnt/minio \
   --name "aistor-server" \
   minio server
   
   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.

6. Connect to the Deployment

   You can connect to the deployment using the built-in AIStor Server console in a browser, by using the MinIO mc commandline tool, or by using an S3-compatible SDK:

   AIStor Console

   Open your browser to http://localhost:9001.

   Log in using the default minioadmin:minioadmin username and password.

   CLI

   1. Download the mc tool to your local host machine:

      AMD64

      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
      

      ARM64

      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
      

   2. Create a new alias for the AIStor server:

      mc alias set myminio http://localhost:9000 minioadmin minioadmin
      

   3. Create a bucket and copy a file to that bucket:

      mc mb myminio/data
      mc cp ~/somefile.txt myminio/data