CyanPrintManage the Daemon
Start and stop the CyanPrint Coordinator daemon for local development
Manage the Daemon
CyanPrint has a hosted coordinator at http://coord.cyanprint.dev:9000 which is used by default — you don't need to run anything locally to create projects.
However, you may want to host the coordinator locally for security or privacy reasons (e.g., to keep template execution on your own machine).
Docker must be installed and running before using daemon commands.
Export Coordinator Endpoint
When running a local daemon, override the default hosted endpoint:
export CYANPRINT_COORDINATOR=http://localhost:9000
This tells the CLI to use your local coordinator instead of the hosted one.
Start the Daemon
Start with Defaults
cyanprint daemon start
This starts the coordinator on port 9000 using the latest version.
Verify It's Running
docker ps | grep cyanprint
You should see a container named cyanprint-coordinator running.
Stop the Daemon
Stop and Cleanup
cyanprint daemon stop
This command calls the cleanup endpoint to remove Docker resources and removes the coordinator container.
Options
Custom Port
Use a different port if 9000 is in use:
cyanprint daemon start --port 8080
When using a custom port, specify it with other commands:
cyanprint create template:1 ./project -c http://localhost:8080
Specific Version
Use a specific coordinator version instead of latest:
cyanprint daemon start 1.5.0
Custom Registry
Point the coordinator to a different registry:
cyanprint daemon start --registry https://custom-registry.example.com
The --registry option can also be set via the CYANPRINT_REGISTRY environment variable.
Command Reference
daemon start
| Argument | Default | Description |
|---|---|---|
[version] | latest | Coordinator version to use |
--port | 9000 | Port to host the daemon |
--registry | Default registry | Registry endpoint for the coordinator |
daemon stop
| Option | Default | Description |
|---|---|---|
--port | 9000 | Port where the daemon is running |
Troubleshooting
Docker Not Running
If you see connection errors:
Error: Failed to connect to Docker daemon
Start Docker Desktop or the Docker daemon.
Port Already in Use
If port 9000 is taken:
cyanprint daemon start --port 9001
Or stop any existing daemon first:
cyanprint daemon stop
Next Steps
- Create a Project - Generate from templates