Start Command

# Start with default configuration
elizaos start

# Start on custom port
elizaos start --port 8080

# Force reconfiguration
elizaos start --configure

# Start with single character file
elizaos start --character ./character.json

# Start with multiple character files
elizaos start --character ./char1.json ./char2.json

# Mix local files and URLs
elizaos start --character ./local.json https://example.com/remote.json

# Character files without .json extension
elizaos start --character assistant support-bot

# Comma-separated format also works
elizaos start --character "char1.json,char2.json"

# Reconfigure services before starting
elizaos start --configure

# Start with specific character on custom port
elizaos start --character ./my-bot.json --port 4000

# Complete setup for production deployment
elizaos start --character ./production-bot.json --port 3000

# With environment file
cp .env.production .env
elizaos start

# Background process (Linux/macOS)
nohup elizaos start > elizaos.log 2>&1 &

# Verify service is running
curl http://localhost:3000/health

# Check process status
ps aux | grep elizaos

# Monitor logs
tail -f elizaos.log

# Bypass saved configuration and reconfigure all services
elizaos start --configure

# elizaOS looks for .env in the project directory
cd my-project
elizaos start  # Loads from ./my-project/.env

# Set variables directly
OPENAI_API_KEY=your-key elizaos start

# Multiple variables
OPENAI_API_KEY=key1 DISCORD_TOKEN=token1 elizaos start

# Specify custom port
elizaos start --port 8080

# Check if port is available first
netstat -an | grep :8080
elizaos start --port 8080

# Build separately before starting
bun run build
elizaos start

# Verify service is running
curl http://localhost:3000/health

# Check process status
ps aux | grep elizaos

# Monitor logs
tail -f elizaos.log

# Check if another instance is running
ps aux | grep elizaos
pkill -f elizaos

# Clear any conflicting processes
# Press Ctrl+C in the terminal where elizaos start is running
elizaos start

# Check what's using the port
lsof -i :3000

# Use different port
elizaos start --port 3001

# Or stop conflicting service
sudo kill -9 $(lsof -ti:3000)
elizaos start

# Verify character file exists and is valid JSON
cat ./character.json | jq .

# Test with absolute path
elizaos start --character /full/path/to/character.json

# Start without character to use default
elizaos start

# Force reconfiguration to fix corrupted settings
elizaos start --configure

# Check environment variables
elizaos env list

# Reset environment if needed
elizaos env reset
elizaos start --configure

# Build separately and check for errors
bun run build

# If build succeeds, then start
elizaos start

# Install dependencies if missing
bun install
bun run build
elizaos start

# Check internet connectivity
ping google.com

# Verify API keys are set
elizaos env list

# Test with minimal configuration
elizaos start --configure