In this article, we will see how to install and setup MinIO Object Storage on Ubuntu or Debian Linux. MinIO is a free and open source object storage solution compatible with Amazon S3 (Simple Storage Service) API and support all its core S3 features, thus making it easy to integrate into applications that already use AWS S3. MinIO is built for unstructured data storage, such as photos, videos, log files, backups, and container images, and is widely used for cloud-native applications. Even with larger volumes of data, it provides high throughput and low latency. It is high scalable and an ideal choice for handling large amount of data.
If you are worried about security then it provides end-to-end encryption for secure data transfer and storage. It is available in both free and commercial license. You can use either of them depending on your requirements. MinIO can be easily deployed in both private as well public cloud environment, bare metal infrastructure, orchestrated environments, and edge infrastructure. Check more on official website.
How to Install and Setup MinIO Object Storage on Ubuntu or Debian Linux
Also Read: How to Install bunzip2 on Ubuntu or Debian Linux
Step 1: Prerequisites
a) You should have a running Ubuntu or Debian based Linux Server.
b) You should have sudo or root access to run privileged commands.
c) You should have wget and dpkg utility installed in your Server.
Step 2: Update Your Server
Before installing any new packages in your system, it is important to check for latest feature updates and bugfixes and install them by using sudo apt update && sudo apt upgrade command as shown below. This will keep your system stable and secure.
Ubuntu-Server@ubuntu:~$ sudo apt update && sudo apt upgrade
Step 3: Download MinIO Debian Package
You can visit MinIO official installation page and look for latest step to download debian package in your ubuntu or debian based linux system. As of yet, we see below wget command to download latest version of MinIO package as minio.deb in current working directory. To know more about wget utility, check What is wget and How to use wget command in Linux(20 Popular wget examples)
Ubuntu-Server@ubuntu:~$ wget https://dl.min.io/server/minio/release/linux-amd64/archive/minio_20241107005220.0.0_amd64.deb -O minio.deb --2024-11-29 02:26:46-- https://dl.min.io/server/minio/release/linux-amd64/archive/minio_20241107005220.0.0_amd64.deb Resolving dl.min.io (dl.min.io)... 138.68.11.125, 178.128.69.202 Connecting to dl.min.io (dl.min.io)|138.68.11.125|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 37426422 (36M) [application/vnd.debian.binary-package] Saving to: ‘minio.deb’ minio.deb 100%[=================================================================>] 35.69M 2.42MB/s in 18s 2024-11-29 02:27:04 (2.03 MB/s) - ‘minio.deb’ saved [37426422/37426422]
Step 4: Install MinIO
To install MinIO from downloaded debian package, run sudo dpkg -i minio.deb command as shown below. To know more about usage of dpkg utility, check 21+ Practical dpkg Command Examples for Linux Beginners
Ubuntu-Server@ubuntu:~$ sudo dpkg -i minio.deb [sudo] password for Ubuntu-Server: Selecting previously unselected package minio. (Reading database ... 241336 files and directories currently installed.) Preparing to unpack minio.deb ... Unpacking minio (20241107005220.0.0) ... Setting up minio (20241107005220.0.0) ...
Step 5: Launch MinIO
Before launching MinIO, you have to create a folder from where server can operate. Here we are creating a folder called minio under user’s home directory using mkdir ~/minio command as shown below.
Ubuntu-Server@ubuntu:~$ mkdir ~/minioThen launch minio server by using minio server ~/minio --console-address :9001 command as shown below.
Ubuntu-Server@ubuntu:~$ minio server ~/minio --console-address :9001 INFO: Formatting 1st pool, 1 set(s), 1 drives per set. INFO: WARNING: Host local has more than 0 drives of set. A host failure will result in data becoming unavailable. MinIO Object Storage Server Copyright: 2015-2024 MinIO, Inc. License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html Version: RELEASE.2024-11-07T00-52-20Z (go1.23.3 linux/amd64) API: http://192.168.0.105:9000 http://127.0.0.1:9000 RootUser: minioadmin RootPass: minioadmin WebUI: http://192.168.0.105:9001 http://127.0.0.1:9001 RootUser: minioadmin RootPass: minioadmin CLI: https://min.io/docs/minio/linux/reference/minio-mc.html#quickstart $ mc alias set 'myminio' 'http://192.168.0.105:9000' 'minioadmin' 'minioadmin' Docs: https://docs.min.io WARN: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables
Step 6: Access MinIO Console
To access MinIO console through GUI, go to your favorite web browser and open url http://127.0.0.1:9000 as shown below. If you have any firewall running on your system then make sure to allow Port 9000 through it or login page will not open.
You will get credentials from output screen to login. After fresh installation, you will notice on output that user given is minioadmin and password is minioadmin. Provide these credential and click on Login.
After successful login, you should see MinIO Console opened like below.
Step 7: Create a Bucket(Using GUI)
You can create your first bucket by using both GUI as well as command line interface. Let’s see how to create using GUI Interface. Under Buckets, you will see an option to Create a Bucket as shown below. Click on it on proceed.
As you notice, below page will be opened where you have to provide your bucket name and then select the features you would like to enable or disable. In our case, we are providing bucket name as velero-Ubuntu-Server. Once done, click on Create Bucket.
You would notice that a bucket with name velero-Ubuntu-Server getting created successfully as shown below.
Step 8: Install MinIO Client(Optional)
This is an optional step for those who would like to work on MinIO server through command line rather than through GUI. For this, you have to install MinIO client tool called mc on your system by downloading it first using below wget command.
Ubuntu-Server@ubuntu:~$ wget https://dl.min.io/client/mc/release/linux-amd64/mc --2024-11-29 03:18:26-- https://dl.min.io/client/mc/release/linux-amd64/mc Resolving dl.min.io (dl.min.io)... 138.68.11.125, 178.128.69.202 Connecting to dl.min.io (dl.min.io)|138.68.11.125|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 27996312 (27M) [application/octet-stream] Saving to: ‘mc’ mc 100%[=================================================================>] 26.70M 2.07MB/s in 14s 2024-11-29 03:18:40 (1.96 MB/s) - ‘mc’ saved [27996312/27996312]
Provide execute permission to this tool by using chmod +x mc command as shown below.
Ubuntu-Server@ubuntu:~$ chmod +x mcThen move this utility to any of the location mentioned in global PATH environment variable such as /usr/local/bin.
Ubuntu-Server@ubuntu:~$ sudo mv mc /usr/local/bin/mc [sudo] password for Ubuntu-Server:
Once it is moved, you can check its functionality by running mc --version command as shown below.
Ubuntu-Server@ubuntu:~$ mc --version mc version RELEASE.2024-11-17T19-35-25Z (commit-id=bb4ff4951a3e54bbee6ac75cfaf387c521e98709) Runtime: go1.23.3 linux/amd64 Copyright (c) 2015-2024 MinIO, Inc. License GNU AGPLv3
This confirms that client tool is working as expected.
Step 9: Configure MinIO Client
To enable mc client interaction with MinIO server, you have to setup an alias for the server running at http://127.0.0.1:9000 using access key and secret key. For example, here we are setting up an alias called local for the MinIO server running at http://127.0.0.1:9000 using access key minioadmin and secret key minioadmin by running mc alias set local http://127.0.0.1:9000 minioadmin minioadmin command as shown below.
Ubuntu-Server@ubuntu:~$ mc alias set local http://127.0.0.1:9000 minioadmin minioadmin mc: Configuration written to `/home/Ubuntu-Server/.mc/config.json`. Please update your access credentials. mc: Successfully created `/home/Ubuntu-Server/.mc/share`. mc: Initialized share uploads `/home/Ubuntu-Server/.mc/share/uploads.json` file. mc: Initialized share downloads `/home/Ubuntu-Server/.mc/share/downloads.json` file. Added `local` successfully.
Step 10: Check info about an alias
After adding an alias, you can check information about this using mc admin info command. Since we created an alias called local, to check information about this alias, run mc admin info local command as shown below.
Ubuntu-Server@ubuntu:~$ mc admin info local ● 127.0.0.1:9000 Uptime: 1 hour Version: 2024-11-07T00:52:20Z Network: 1/1 OK Drives: 1/1 OK Pool: 1 ┌──────┬───────────────────────┬─────────────────────┬──────────────┐ │ Pool │ Drives Usage │ Erasure stripe size │ Erasure sets │ │ 1st │ 21.5% (total: 92 GiB) │ 1 │ 1 │ └──────┴───────────────────────┴─────────────────────┴──────────────┘ 0 B Used, 1 Bucket, 0 Objects 1 drive online, 0 drives offline, EC:0
Step 11: Remove an alias
You can also remove an alias using mc alias remove command. For example, to remove alias local, you have to use mc alias remove local command as shown below.
Ubuntu-Server@ubuntu:~$ mc alias remove local Removed `local` successfully.
Step 12: Create a Bucket(Using terminal)
We have seen earlier how to create a bucket using graphical user interface. Now let’s see how to create a bucket using command line. To create a bucket in MinIO configured with an alias, use mc mb command. For example, in our case we would like to create a bucket called velero-Ubuntu-Server in MinIO server which is configured with an alias called local. To do this, run mc mb local/velero-Ubuntu-Server command as shown below.
Ubuntu-Server@ubuntu:~$ mc mb local/velero-Ubuntu-Server Bucket created successfully `local/velero-Ubuntu-Server`.
Step 13: Remove a Bucket
Before removing a bucket, you have to make sure there are no contents in it. It is simply because MinIO does not allow us to remove bucket unless it is empty. To check the list of contents in bucket, use mc ls command. For example, in our case to check the contents in velero-Ubuntu-Server, run mc ls local/velero-Ubuntu-Server command as shown below.
Ubuntu-Server@ubuntu:~$ mc ls local/velero-Ubuntu-ServerIf you find contents in your bucket, then to remove and empty the bucket run mc rm --recursive --force command. For example, in our case to remove all contents in bucket velero-Ubuntu-Server in MinIO server configured with alias local, run mc rm --recursive --force local/velero-Ubuntu-Server command as shown below.
Ubuntu-Server@ubuntu:~$ mc rm --recursive --force local/velero-Ubuntu-ServerOnce the bucket is empty, you can remove it by using mc rb local/velero-Ubuntu-Server command as shown below.
Ubuntu-Server@ubuntu:~$ mc rb local/velero-Ubuntu-Server Removed `local/velero-Ubuntu-Server` successfully.
Discover more from Ubuntu-Server.com
Subscribe to get the latest posts sent to your email.
