lc doctor
Diagnose system health, detect common issues, and provide solutions for LocalCloud setup and operation problems.Usage
Flags
Flag | Description | Default |
---|---|---|
--fix | Attempt to automatically fix detected issues | false |
What Doctor Checks
System Requirements
Docker Installation
- Docker daemon is running
- Docker version compatibility (20.10+)
- Docker API accessibility
- Container runtime availability
System Resources
- Available memory (minimum 8GB recommended)
- Available disk space (minimum 20GB)
- CPU cores and architecture
- Operating system compatibility
Network Configuration
- Port availability (5432, 6379, 9000, 11434, 27017)
- Network connectivity
- DNS resolution
- Internet access for model downloads
LocalCloud Configuration
Project Setup
- Valid LocalCloud project directory
- Configuration file syntax and completeness
- Component dependencies satisfied
- Service configurations valid
File Permissions
- Read/write access to project directory
- Docker socket permissions
- Log file accessibility
- Data volume permissions
Examples
Basic Health Check
Health Check with Issues
Automatic Fix Attempt
Detailed Check Categories
Docker Health
-
Docker Not Running
-
Permission Denied
-
Version Too Old
Resource Checks
Memory Requirements
Component | Minimum | Recommended |
---|---|---|
Ollama (3B model) | 2GB | 4GB |
PostgreSQL | 512MB | 1GB |
MongoDB | 512MB | 1GB |
Redis | 128MB | 512MB |
MinIO | 256MB | 512MB |
Total | 3.4GB | 7GB |
Disk Space Requirements
Component | Usage |
---|---|
Docker images | 3-5GB |
AI models | 2-50GB (per model) |
Database data | Variable |
Logs | 100MB-1GB |
Recommended minimum | 20GB |
Port Availability
Doctor checks these default ports and suggests alternatives if conflicts exist:Service | Default Port | Alternative |
---|---|---|
PostgreSQL | 5432 | 5433, 5434 |
MongoDB | 27017 | 27018, 27019 |
Redis | 6379 | 6380, 6381 |
MinIO API | 9000 | 9002, 9003 |
MinIO Console | 9001 | 9004, 9005 |
Ollama | 11434 | 11435, 11436 |
Configuration Validation
Common Configuration Issues
-
YAML Syntax Errors
-
Missing Required Fields
-
Invalid Resource Specifications
Diagnostic Commands
Manual System Checks
LocalCloud Specific Checks
Troubleshooting Guide
Cannot Start Services
Symptoms:- Services fail to start
- Container errors
- Connection timeouts
- Port conflicts � Change ports in config
- Insufficient memory � Reduce model sizes
- Docker issues � Restart Docker
- Permission problems � Fix file permissions
Model Download Failures
Symptoms:- Model pull commands timeout
- Network errors during download
- Incomplete model files
- Check internet connectivity
- Verify disk space
- Try smaller models first
- Check Ollama service status
Performance Issues
Symptoms:- Slow model responses
- High memory usage
- System freezing
- Use smaller models
- Increase system memory
- Close other applications
- Check CPU temperature
Best Practices
Regular Health Checks
Preventive Maintenance
- Keep Docker Updated: Newer versions have better performance
- Monitor Disk Space: Clean up unused images regularly
- Review Resource Usage: Adjust allocations based on usage
- Backup Configurations: Keep working configs in version control
Environment-Specific Checks
Related Commands
lc info
- Show detailed system informationlc status
- Check service statuslc logs
- View service logslc config validate
- Validate configurationlc reset
- Reset system to clean state