This procedure deploys a Standalone MinIO server onto Linux for early development and evaluation of MinIO Object Storage and it’s S3-compatible API layer.
Standalone deployments (also called “filesystem mode”) support a subset of MinIO features where redundancy or availability are dependent entirely on the underlying drive or volume.
For instructions on deploying to production environments, see Deploy MinIO in Distributed Mode.
Read, Write and Execute permissions on your local user folder (e.g.
Permission to install binaries to the system
PATH (e.g. access to
Familiarity with the Linux terminal or shell (Bash, ZSH, etc.).
A 64-bit Linux OS (e.g. RHEL 8, Ubuntu LTS releases).
Install the MinIO Server
The following tabs provide examples of installing MinIO onto 64-bit Linux
operating systems using RPM, DEB, or binary. The RPM and DEB packages
automatically install MinIO to the necessary system paths and create a
systemd service file for running MinIO automatically. MinIO strongly
recommends using RPM or DEB installation routes.
Use the following commands to download the latest stable MinIO RPM and install it.
wget https://dl.min.io/server/minio/release/linux-amd64/minio-20220519182059.0.0.x86_64.rpm -O minio.deb sudo dnf install minio.rpm
Use the following commands to download the latest stable MinIO DEB and install it:
wget https://dl.min.io/server/minio/release/linux-amd64/minio_20220519182059.0.0_amd64.deb -O minio.deb sudo dpkg -i minio.deb
Use the following commands to download the latest stable MinIO binary and
install it to the system
wget https://dl.min.io/server/minio/release/linux-amd64/minio chmod +x minio sudo mv minio /usr/local/bin/
Launch the MinIO Server
Run the following command from the system terminal or shell to start a local MinIO instance using the
~/minio folder. You can replace this path with another folder path on the local machine:
mkdir ~/minio minio server ~/minio --console-address :9090
mkdir command creates the folder explicitly at the specified path.
minio server command starts the MinIO server. The path argument
~/minio identifies the folder in which the server operates.
minio server process prints its output to the system console, similar to the following:
API: http://192.0.2.10:9000 http://127.0.0.1:9000 RootUser: minioadmin RootPass: minioadmin Console: http://192.0.2.10:9090 http://127.0.0.1:9090 RootUser: minioadmin RootPass: minioadmin Command-line: https://docs.min.io/docs/minio-client-quickstart-guide $ mc alias set myminio http://192.0.2.10:9000 minioadmin minioadmin Documentation: https://docs.min.io WARNING: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables.
Connect Your Browser to the MinIO Server
Open http://127.0.0.1:9000 in a web browser to access the MinIO Console. You can alternatively enter any of the network addresses specified as part of the server command output. For example, Console: http://192.0.2.10:9090 http://127.0.0.1:9090 in the example output indicates two possible addresses to use for connecting to the Console.
While the port
9000 is used for connecting to the API, MinIO automatically redirects browser access to the MinIO Console.
Log in to the Console with the
RootPass user credentials displayed in the output.
These default to
minioadmin | minioadmin.
You can use the MinIO Console for general administration tasks like Identity and Access Management, Metrics and Log Monitoring, or Server Configuration. Each MinIO server includes its own embedded MinIO Console.
For more information, see the MinIO Console documentation.
(Optional) Install the MinIO Client
The MinIO Client allows you to work with your MinIO server from the commandline.
mc client and install it to a location on your system
PATH such as
/usr/local/bin. You can alternatively run the binary from the download location.
wget https://dl.min.io/client/mc/release/linux-amd64/mc chmod +x mc sudo mv mc /usr/local/bin/mc
mc alias set local http://127.0.0.1:9000 minioadmin minioadmin mc admin info local
mc alias set takes four arguments:
The name of the alias
The hostname or IP address and port of the MinIO server
The Access Key for a MinIO user
The Secret Key for a MinIO user
The example above uses the root user.