Files

T

paul 9cfd018d0d feat: Add flexible port configuration for development

- Change default ports to 7510 (backend) and 7511 (frontend) to avoid conflicts
- Add PORT environment variable support for both services
- Create docker-compose.dev.yml for development without SSL/nginx
- Add development script (scripts/dev.sh) for easy local development
- Create comprehensive port configuration documentation
- Update docker-compose.yml to support dynamic port configuration
- Add frontend .env.example with development settings

This allows running the application on custom ports internally without SSL,
making it easier to integrate with existing infrastructure.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-07-23 14:11:11 +02:00

2.5 KiB

Raw Permalink Blame History

Port Configuration Guide

MinIO WebUI supports flexible port configuration for both frontend and backend services.

Default Ports

Backend API: 7510
Frontend UI: 7511

These ports were chosen to avoid conflicts with commonly used ports like 3000.

Configuration Methods

1. Environment Variables

Set these in your .env file:

# Backend port
PORT=7510

# Frontend port (for development)
FRONTEND_PORT=7511

2. Docker Compose

The production docker-compose.yml uses environment variables:

backend:
  ports:
    - "${PORT:-7510}:${PORT:-7510}"

frontend:
  ports:
    - "${FRONTEND_PORT:-7511}:80"

3. Development Mode

Using the dev script:

# Start with local Node.js
./scripts/dev.sh

# Start with Docker
./scripts/dev.sh docker

Manual start:

# Backend
cd backend
PORT=7510 npm run dev

# Frontend (in another terminal)
cd frontend
PORT=7511 REACT_APP_API_URL=http://localhost:7510/api npm start

4. Docker Development Mode

Use the dedicated development compose file:

docker compose -f docker-compose.dev.yml up

This configuration:

Runs backend on port 7510
Runs frontend on port 7511
Enables hot reloading for both services
No SSL/nginx proxy needed

Accessing the Application

Development Mode

Frontend: http://localhost:7511
Backend API: http://localhost:7510/api
Health check: http://localhost:7510/health

Production Mode (with nginx)

Frontend: http://localhost:7511
API calls are proxied through nginx

Changing Ports

To use different ports:

Update your .env file:
```
PORT=8510
FRONTEND_PORT=8511
```
If using the frontend development server, update frontend/.env:
```
PORT=8511
REACT_APP_API_URL=http://localhost:8510
```
Restart your services

Troubleshooting

Port Already in Use

If you get a "port already in use" error:

Check what's using the port:

# Linux/Mac
lsof -i :7510

# Windows
netstat -ano | findstr :7510

Either stop the conflicting service or choose a different port

API Connection Issues

If the frontend can't connect to the backend:

Verify the backend is running on the expected port
Check REACT_APP_API_URL in the frontend environment
Ensure no firewall is blocking the connection

Docker Network Issues

If services can't communicate in Docker:

Ensure both services are on the same network
Use service names (not localhost) for inter-container communication
Check Docker logs: docker compose logs backend

2.5 KiB Raw Permalink Blame History