CLI Reference

runnem up

Start one or all services in your project.

Usage

runnem up [service]

Description

The up command starts services in your project. You can either start all services or a specific service. When starting services, runnem:

  1. Checks for running services from other projects
  2. Validates service dependencies
  3. Checks for port conflicts
  4. Starts services in the correct order based on dependencies
  5. Waits for services to be ready before starting dependent services

Examples

# Start all services
runnem up

# Start a specific service
runnem up api

How it works

  1. Dependency Checking:

    • Builds a dependency graph
    • Detects circular dependencies
    • Sorts services by dependency order
  2. Port Management:

    • Checks if required ports are available
    • Cleans up any processes using required ports
    • Ensures clean startup environment
  3. Service Startup:

    • Starts independent services first
    • Waits for dependencies to be ready
    • Checks service health via URLs
    • Provides status updates for each service
  4. Error Handling:

    • Captures startup errors
    • Provides detailed error logs
    • Cleans up resources on failure

Service Status

During startup, you'll see status messages for each service:

  • 🚀 Starting service...
  • âś… Started service (with URL if configured)
  • ❌ Failed to start service (with error details)

Best Practices

  1. Always check the status messages
  2. Use URLs in service configurations for better health checking
  3. Keep dependency chains simple
  4. Monitor logs for startup issues
Previous
runnem init