​

lc start

​

Usage

lc start [service] [flags]

​

Arguments

• service (optional) - Specific service to start. Valid values: ai, postgres, cache, queue, minio, all

​

Flags

​

Examples

​

Start all services

lc start

​

Start specific service

lc start ai
lc start postgres
lc start cache

​

Start multiple specific services

lc start --only ai,cache

​

Service Names

​

What Happens When Starting

1. Pre-flight Checks

• Verifies Docker is running
• Checks project configuration
• Validates component configuration

2. Service Startup

• Creates Docker network if needed
• Starts services in dependency order:

1. Database (PostgreSQL)
2. Cache/Queue (Redis)
3. Storage (MinIO)
4. AI (Ollama)

• Waits for health checks

3. Model Management

• Downloads AI models if not present
• Shows download progress
• Validates model availability

4. Connection Info

• Displays service URLs
• Shows access credentials
• Provides example usage

​

Component-Based Startup

​

Output Example

Starting services for configured components: llm, database, cache

✓ Network created
✓ PostgreSQL started (localhost:5432)
✓ Redis started (localhost:6379)
✓ Ollama started (http://localhost:11434)

Downloading model llama2...
[████████████████████] 100% 3.8GB/3.8GB

All services are running!

Connection Information:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ AI (Ollama): http://localhost:11434
✓ PostgreSQL: postgresql://localcloud:localcloud@localhost:5432/localcloud
✓ Redis: redis://localhost:6379
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

​

Error Handling

​

Docker not running

Error: Docker is not running. Please start Docker Desktop first

​

No components configured

Warning: No components configured in this project.

To configure components, run:
  • lc setup
  • Or: lc component add <component-id>

​

Port already in use

Error: port 5432 is already in use by another process

​

Model download failed

Error: failed to pull model llama2: connection timeout

​

Health Checks

• PostgreSQL: Checks database connectivity
• Redis: Pings the service
• MinIO: Verifies API availability
• Ollama: Checks API endpoint

​

Resource Management

• Warns if available RAM is low
• Suggests smaller models if needed
• Shows memory usage per service

​

Advanced Usage

​

Start with verbose output

lc start --verbose

​

Skip connection info

lc start --info=false

​

Start services for specific components

# First, add components
lc component add llm
lc component add cache

# Then start only those services
lc start

​

Service Dependencies

​

Related Commands

• lc stop - Stop services
• lc status - Check service status
• lc logs - View service logs
• lc services - List running services