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:
2025-07-23 17:06:24 +02:00
parent 55983d0088
commit cdd4dcc2db
7 changed files with 1212 additions and 12 deletions
+70 -4
View File
@@ -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**