mirror of
https://github.com/rustfs/rustfs.git
synced 2026-01-16 17:20:33 +00:00
b3ec2325ed
* refactor(config): Unify S3 API and Console ports This commit streamlines the server configuration by unifying the S3 API and the WebUI (Console) to serve on a single port. Previously, the console was managed by separate configuration options (`RUSTFS_CONSOLE_ENABLE` and `RUSTFS_CONSOLE_ADDRESS`), requiring a distinct port. This added complexity to deployment and configuration. With this change: - The `RUSTFS_CONSOLE_ADDRESS` and `RUSTFS_CONSOLE_FS_ENDPOINT` environment variables are removed. - The WebUI is now always available and served directly from the main application port defined by `RUSTFS_ADDRESS`. - This simplifies setup, reduces the number of exposed ports, and makes the application easier to manage and deploy, especially in containerized environments. Users should update their startup scripts and remove the deprecated `RUSTFS_CONSOLE_*` variables. * improve docker comprose config file and remove docs dir
90 lines
1.4 KiB
Markdown
90 lines
1.4 KiB
Markdown
# RustFS Service Installation Guide
|
|
|
|
## 1. Prerequisites
|
|
|
|
### 1.1 Create System User
|
|
|
|
```bash
|
|
# Create rustfs system user and group without login shell
|
|
sudo useradd -r -s /sbin/nologin rustfs
|
|
```
|
|
|
|
### 1.2 Create Required Directories
|
|
|
|
```bash
|
|
# Create program directory
|
|
sudo mkdir -p /opt/rustfs
|
|
|
|
# Create data directories
|
|
sudo mkdir -p /data/rustfs/{vol1,vol2}
|
|
|
|
# Create configuration directory
|
|
sudo mkdir -p /etc/rustfs
|
|
|
|
# Set directory permissions
|
|
sudo chown -R rustfs:rustfs /opt/rustfs /data/rustfs
|
|
sudo chmod 755 /opt/rustfs /data/rustfs
|
|
```
|
|
|
|
## 2. Install RustFS
|
|
|
|
```bash
|
|
# Copy RustFS binary
|
|
sudo cp rustfs /usr/local/bin/
|
|
sudo chmod +x /usr/local/bin/rustfs
|
|
|
|
# Copy configuration file
|
|
sudo cp obs.yaml /etc/rustfs/
|
|
sudo chown -R rustfs:rustfs /etc/rustfs
|
|
```
|
|
|
|
## 3. Configure Systemd Service
|
|
|
|
```bash
|
|
# Copy service unit file
|
|
sudo cp rustfs.service /etc/systemd/system/
|
|
|
|
# Reload systemd configuration
|
|
sudo systemctl daemon-reload
|
|
```
|
|
|
|
## 4. Service Management
|
|
|
|
### 4.1 Start Service
|
|
|
|
```bash
|
|
sudo systemctl start rustfs
|
|
```
|
|
|
|
### 4.2 Check Service Status
|
|
|
|
```bash
|
|
sudo systemctl status rustfs
|
|
```
|
|
|
|
### 4.3 Enable Auto-start
|
|
|
|
```bash
|
|
sudo systemctl enable rustfs
|
|
```
|
|
|
|
### 4.4 View Service Logs
|
|
|
|
```bash
|
|
# View real-time logs
|
|
sudo journalctl -u rustfs -f
|
|
|
|
# View today's logs
|
|
sudo journalctl -u rustfs --since today
|
|
```
|
|
|
|
## 5. Verify Installation
|
|
|
|
```bash
|
|
# Check service ports
|
|
ss -tunlp | grep 9000
|
|
|
|
# Test service availability
|
|
curl -I http://localhost:9000
|
|
```
|