Managing the Scheduler Daemon

You can manage the life cycle of the daemon using the -daemon option with the sql command.

Starting the Daemon

You can start the daemon only if it is not already running.

Command

sql -daemon start

Example

sql -daemon start                                                               
Starting SQLcl daemon...
INFO Mon Jun  9 00:09:38 +01 2025: Daemon started with PID 1666

Stopping the Daemon

To stop the daemon, it must currently be running.

Command

sql -daemon stop

Example

sql -daemon stop                                                                
INFO Mon Jun  9 00:11:08 +01 2025: Daemon stopped, process with PID 1666 has been killed

Restarting the Daemon

To stop and then immediately start the daemon in a single operation, use the restart command. This is useful for applying configuration changes that are not subject to live reloading.

Command

sql -daemon restart

Example

sql -daemon restart                                                             
INFO Mon Jun  9 00:14:09 +01 2025: Daemon stopped, process with PID 2372 has been killed
Starting SQLcl daemon...
INFO Mon Jun  9 00:14:13 +01 2025: Daemon started with PID 2464

Checking the Daemon Status

Use this command to check if the daemon is running for the current user.

Command

sql -daemon status

Example

sql -daemon status                                                              
INFO Mon Jun  9 00:15:39 +01 2025: Daemon is running (PID 2464)