> For the complete documentation index, see [llms.txt](https://docs.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neevcloud.com/neevcloud-guide/neevcloud-knowledgebase/minio-object-storage/minio-installation-and-configuration-guide.md).
# MinIO Installation and Configuration Guide
**1. Prerequisites**
Before proceeding with the installation and configuration of MinIO, ensure the following requirements are met:
* **Operating System:** Ubuntu 20.04 / 22.04 / 24.04
* **User Access:** A user account with **sudo (administrative) privileges**
* **Open Network Ports:**
* **Port 9000** – Required for MinIO API access
* **Port 9001** – Required for MinIO Web Console (Dashboard)
***
**2. Install MinIO Server**
```
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
sudo mv minio /usr/local/bin/
```
**3. Create Storage Directory**
```
mkdir /home/ubuntu/minio
```
*(Change path if using a different user)*
**4.Firewall Configuration :**
**4.1: Check if UFW (Uncomplicated Firewall) is active**
```
sudo ufw status
```
* If you see **`Status: inactive`**, skip the next steps.
* If you see **`Status: active`**, continue below to allow the required ports.
**4.2: Allow MinIO Ports (only if firewall is active)**
```
sudo ufw allow 9000/tcp
sudo ufw allow 9001/tcp
sudo ufw reload
```
**5. Run MinIO (First Time Startup Test)**
```
minio server /home/ubuntu/minio --console-address ":9001"
```
Access:
* Web Console → `http://:9001`
* Default credentials → `minioadmin / minioadmin`
(**Stop with Ctrl + C after testing**).
***
**6. Configure MinIO as Systemd Service**
**Create service file:**
```
sudo nano /etc/systemd/system/minio.service
```
**paste below content:** Copy the config
```
[Unit]
Description=MinIO Object Storage Service
Documentation=https://docs.min.io
Wants=network-online.target
After=network-online.target
[Service]
User=root
Group=root
ExecStart=/usr/local/bin/minio server /home/ubuntu/minio --console-address ":9001"
Environment="MINIO_ROOT_USER=myadmin" #set username
Environment="MINIO_ROOT_PASSWORD=MyStrongPassword123" #set password
Restart=always
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
```
* After editing your file in nano, press:\
\&#xNAN;**`Ctrl + O`** → It will show: *"File Name to Write: /path/filename"*
* Press **Enter** to confirm and save.
* Press **`Ctrl + X`** to exit nano editor.
***
**7. Enable and Start Service**
```
sudo systemctl daemon-reload
sudo systemctl start minio
sudo systemctl enable minio
sudo systemctl status minio
```
***
**8. Access MinIO Dashboard**
* URL: `http://:9001`
* Username: **myadmin**
* Password: **MyStrongPassword123**
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.neevcloud.com/neevcloud-guide/neevcloud-knowledgebase/minio-object-storage/minio-installation-and-configuration-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.