Process Configuration

Configure how the Gigantics application runs as a process, including daemon mode settings.

Configuration Properties

The process configuration section in your config/default.yaml file controls how Gigantics runs as a system process:

process:
  daemon: false
  workers: 0

Type: Boolean
Default: false
Description: Controls whether Gigantics runs as a daemon process in the background

Type: Number
Default: 0
Description: Controls clustering mode for the application:
- -1: Disable clustering
- 0: Fork to all available CPUs
- N: Fork to N workers (where N is a positive number)

process:
  daemon: false
  workers: 0

process:
  daemon: true
  workers: 0

process:
  daemon: false
  workers: 4

process:
  daemon: false
  workers: -1

To run Gigantics as a daemon process, you can either:

Set daemon: true in the configuration file:
process: daemon: true workers: 0
Use the command line flag:
./gig start -d

Gigantics supports running in cluster mode to utilize multiple CPU cores:

Single process (workers: -1): Runs as a single process, good for development
All CPUs (workers: 0): Forks a worker for each available CPU core
Specific number (workers: N): Forks exactly N worker processes

Development: Use daemon: false and workers: -1 for easier debugging
Production: Consider using daemon: true for background operation
Performance: Use clustering (workers: 0) in production for better performance
Resource Management: Set a specific number of workers if you need to limit resource usage

After modifying process configuration, restart the application:

./gig stop
./gig start

You can also start with specific flags to override the configuration:

# Run as daemon regardless of config
./gig start -d
 
# Run with specific number of workers
./gig start -w=4