Troubleshooting

Common Issues

1. Permission Denied (Linux/macOS)

chmod +x koneksi-engine/koneksi
chmod +x koneksi-cli/koneksi

2. Port Already in Use

# Find process using port
lsof -i :3080  # Linux/macOS
netstat -ano | findstr :3080  # Windows

# Kill process
kill -9 <PID>  # Linux/macOS
taskkill /PID <PID> /F  # Windows

3. Connection Refused

• Check firewall settings

• Verify API_URL in .env file

• Ensure network connectivity

4. Engine connection failed

request failed: Get "http://localhost:3080/check-health": dial tcp [::1]:3080: connectex: No connection could be made because the target machine actively refused it..
Please ensure the engine service is running and accessible.

• Make sure Engine service is running by checking:

lsof -i :3080  # Linux/macOS
netstat -ano | findstr :3080  # Windows

• If there's no task/service running, we need to run the setup CLI setup again and choose Option 2.