mirror of
https://github.com/rustfs/rustfs.git
synced 2026-01-17 09:40:32 +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
1.4 KiB
1.4 KiB
RustFS Service Installation Guide
1. Prerequisites
1.1 Create System User
# Create rustfs system user and group without login shell
sudo useradd -r -s /sbin/nologin rustfs
1.2 Create Required Directories
# 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
# 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
# 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
sudo systemctl start rustfs
4.2 Check Service Status
sudo systemctl status rustfs
4.3 Enable Auto-start
sudo systemctl enable rustfs
4.4 View Service Logs
# View real-time logs
sudo journalctl -u rustfs -f
# View today's logs
sudo journalctl -u rustfs --since today
5. Verify Installation
# Check service ports
ss -tunlp | grep 9000
# Test service availability
curl -I http://localhost:9000