RuoYi-AI User Frontend

Tech Stack

• Framework: Vue 3 + TypeScript
• UI Components: Ant Design Vue
• State Management: Pinia
• Build Tool: Vite

Docker Deployment

This user frontend supports two Docker deployment methods:

Method 1: Start All Services with One Command (Recommended)

Use docker-compose-all.yaml to start all services at once, including the backend, admin panel, user frontend, and dependencies:

# Clone the backend repository
git clone https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# Start all services using pre-built images
docker-compose -f docker-compose-all.yaml up -d

# Open the user frontend
# URL: http://localhost:25137
# Account: admin / admin123

Method 2: Deploy Services Separately (Build from Source)

If you need to build from source, follow these steps:

Step 1: Deploy the Backend Service

# Enter the backend project directory
cd ruoyi-ai

# Start the backend service and build from source
docker-compose up -d --build

# Wait for the backend service to start
docker-compose logs -f backend

Step 2: Deploy the User Frontend

# Enter the user frontend project directory
cd ruoyi-web

# Build and start the user frontend
docker-compose up -d --build

# Open the user frontend
# URL: http://localhost:5137

Step 3: Deploy the Admin Panel (Optional)

# Enter the admin project directory
cd ruoyi-admin

# Build and start the admin panel
docker-compose up -d --build

# Open the admin panel
# URL: http://localhost:5666

Service Ports

Service	Port	Description
User frontend	5137	User frontend URL
Admin panel	5666	Admin panel URL
Backend service	6039	Backend API service
MySQL	23306	Database service
Redis	6379	Cache service
Weaviate	28080	Vector database
MinIO	9000/9090	Object storage

Local Development

Use Node.js 22.13.0 or later and pnpm 11.0.9, as declared in package.json. pnpm is the supported package manager for local development and Docker builds; pnpm-lock.yaml is the only maintained dependency lockfile. npm and Yarn installs are not supported.

# Install the required pnpm version (npm only bootstraps the tool)
npm install --global [email protected]

# Install the locked dependencies
pnpm install --frozen-lockfile

# Start the development server
pnpm dev

# Build the production version
pnpm build

Use pnpm add, pnpm remove, or pnpm update when intentionally changing dependencies, and commit package.json together with pnpm-lock.yaml. Do not commit lockfiles generated by other package managers. If you previously installed dependencies with npm or Yarn, remove the existing node_modules directory before installing with pnpm.

FAQ

Q: The user frontend cannot connect to the backend service.

A: Make sure the backend service is running and verify that the UPSTREAM_URL environment variable is configured correctly.

Q: What is the difference between one-command startup and separate deployment?

A: One-command startup uses pre-built images for faster deployment. Separate deployment builds from source and is suitable when custom changes are required.

License

This project is licensed under the MIT License. See the license file for details.

---