fix: Resolve API connection issues and add Quick Start features
- Fix API URL configuration to use relative paths (fixes localhost:8080 error) - Add Quick Start Wizard to dashboard for guided bucket/user setup - Create bash scripts for automated bucket and user creation - Add quickstart.sh for interactive setup experience - Update documentation with correct ports and new features - Improve user onboarding with step-by-step wizard This addresses: - Connection refused errors when creating users/policies - WebSocket connection issues - Need for easy one-step setup process - Port configuration clarity in documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -4,6 +4,12 @@ A secure, user-friendly web interface for managing MinIO storage infrastructure.
|
||||
|
||||
## Features
|
||||
|
||||
- **🚀 Quick Start Wizard**
|
||||
- One-click setup for bucket, user, and policy
|
||||
- Step-by-step guided configuration
|
||||
- Automatic credential generation
|
||||
- Built-in best practices
|
||||
|
||||
- **🪣 Bucket Management**
|
||||
- Create buckets with automatic user creation
|
||||
- List and monitor bucket sizes
|
||||
@@ -44,7 +50,21 @@ A secure, user-friendly web interface for managing MinIO storage infrastructure.
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. Clone the Repository
|
||||
### Option 1: Interactive Quick Start Script
|
||||
|
||||
```bash
|
||||
./scripts/quickstart.sh
|
||||
```
|
||||
|
||||
This will:
|
||||
- Check and start all services
|
||||
- Guide you through initial setup
|
||||
- Create your first bucket and user
|
||||
- Provide connection details
|
||||
|
||||
### Option 2: Manual Setup
|
||||
|
||||
#### 1. Clone the Repository
|
||||
|
||||
```bash
|
||||
git clone <repository-url>
|
||||
@@ -105,8 +125,16 @@ All configuration is managed through the `.env` file:
|
||||
### Port Configuration
|
||||
|
||||
Default ports:
|
||||
- Backend API: 7510
|
||||
- Frontend UI: 7511
|
||||
- Backend API: 7510 (not 8080)
|
||||
- Frontend UI: 7511 (development) or 3000 (React default)
|
||||
- MinIO: 9000
|
||||
|
||||
**Important**: The frontend is configured to use relative API URLs. If you're running the backend on a different port or host, set the `REACT_APP_API_URL` environment variable:
|
||||
|
||||
```bash
|
||||
# For development with custom backend URL
|
||||
REACT_APP_API_URL=http://localhost:7510 npm start
|
||||
```
|
||||
|
||||
To use different ports, see [Port Configuration Guide](docs/PORT_CONFIGURATION.md).
|
||||
|
||||
@@ -342,7 +370,45 @@ REPORT_RECIPIENT=info@example.com
|
||||
|
||||
## Usage Guide
|
||||
|
||||
### Creating a Bucket with User
|
||||
### Command-Line Tools
|
||||
|
||||
#### Create Bucket with User Script
|
||||
|
||||
```bash
|
||||
./scripts/create-bucket-with-user.sh -b my-bucket -u my-user -p readwrite
|
||||
```
|
||||
|
||||
Options:
|
||||
- `-b, --bucket <name>`: Bucket name (auto-generated if not specified)
|
||||
- `-u, --user <name>`: User name (auto-generated if not specified)
|
||||
- `-p, --policy <type>`: Policy type: `readonly`, `writeonly`, `readwrite` (default)
|
||||
- `-a, --api-url <url>`: API URL (default: http://localhost:7510)
|
||||
- `--admin-user <user>`: Admin username for authentication
|
||||
- `--admin-pass <pass>`: Admin password for authentication
|
||||
|
||||
#### Quick Start Script
|
||||
|
||||
```bash
|
||||
./scripts/quickstart.sh
|
||||
```
|
||||
|
||||
This interactive script will:
|
||||
1. Check if services are running
|
||||
2. Optionally start services using docker-compose
|
||||
3. Guide you through creating an initial bucket and user
|
||||
4. Provide MinIO CLI commands for testing
|
||||
|
||||
### Web Interface
|
||||
|
||||
#### Quick Start Wizard
|
||||
|
||||
Click the "Quick Start" button on the dashboard for a guided setup that will:
|
||||
- Create a bucket
|
||||
- Set up a user with secure password
|
||||
- Configure appropriate access policies
|
||||
- Provide ready-to-use credentials
|
||||
|
||||
#### Creating a Bucket with User
|
||||
|
||||
1. Navigate to **Buckets** page
|
||||
2. Click **Create Bucket**
|
||||
|
||||
Reference in New Issue
Block a user