Managing Services
NeoCode provides a unified interface for controlling all NeoEngine services. Start, stop, monitor, and debug your node from one place.
Available Services
| Service | Description | Default Port |
|---|---|---|
| Daemon | Worker node that executes jobs | - |
| Coordinator | Job routing and queue management | 8080 |
| Gateway | API gateway and authentication | 3000 |
| Indexer | Blockchain event indexer | 8081 |
| Oracle | Price oracle service | 8082 |
| Aggregator | Data aggregation | 8083 |
| Marketplace | Listing management | 8084 |
| Auth | Authentication service | 8085 |
| Validator | Local Solana validator (dev) | 8899 |
Starting Services
Open a service tab
Click on a service in the sidebar, or use the command bar:
/open daemonStart the service
Click the play button in the toolbar, or press Cmd/Ctrl + Enter.
Monitor logs
Watch the real-time logs for any errors or status updates.
Services start in the order they depend on each other. The daemon requires the coordinator, which requires the gateway.
Stopping Services
Click the stop button or press Cmd/Ctrl + Shift + Enter.
For graceful shutdown, services will:
- Stop accepting new work
- Complete in-progress jobs
- Clean up resources
- Exit
Force stop is available if a service becomes unresponsive.
Service Status
Each service shows its current status:
| Status | Indicator | Description |
|---|---|---|
| Stopped | Gray | Service is not running |
| Starting | Yellow | Service is initializing |
| Running | Green | Service is healthy |
| Warning | Orange | Service has issues but running |
| Error | Red | Service failed or crashed |
Log Levels
Filter logs by level:
- ERROR — Critical issues requiring attention
- WARN — Potential problems
- INFO — Normal operation messages
- DEBUG — Detailed debugging information
Use the filter buttons or command:
/filter error
/filter warn,errorLog Actions
Search
Press Cmd/Ctrl + F or use the search icon to find specific log entries.
Copy
Select log lines and press Cmd/Ctrl + C to copy.
Export
Save logs to file:
/save logsOr use Cmd/Ctrl + S when focused on a service tab.
Clear
Clear the log view (doesn’t affect actual logs):
/clearOr press Cmd/Ctrl + L.
Service Configuration
Access service settings via:
- Right-click the service in sidebar
- Select “Settings”
- Modify configuration
- Restart to apply changes
Common configurations:
| Service | Key Settings |
|---|---|
| Daemon | Auto-accept jobs, resource limits, pricing |
| Gateway | Port, TLS, rate limits |
| Coordinator | Queue settings, matching algorithm |
| Indexer | RPC endpoint, sync mode |
Quick Actions
Start All
/start allStarts all services in dependency order.
Stop All
/stop allGracefully stops all services.
Restart Service
/restart daemonOr press Cmd/Ctrl + Shift + R on the service tab.
Health Monitoring
NeoCode continuously monitors service health:
- Response time — API latency
- Memory usage — RAM consumption
- CPU usage — Processing load
- Error rate — Recent failures
View health metrics in the service tab header or the Hardware views.
Troubleshooting
Service won’t start
- Check logs for error messages
- Verify port is not in use
- Check dependencies are running
- Review configuration
Service crashes repeatedly
- Check system resources (RAM, disk)
- Look for error patterns in logs
- Try resetting to default config
- Check for updates
Logs not appearing
- Ensure service is actually running
- Check log level filter
- Try refreshing with
Cmd/Ctrl + R - Restart NeoCode if needed