Logger

Deprecated: logs

The property is log. The older logs spelling is still accepted but emits a deprecation warning (VERWAR002) on startup and may be removed at any time.

As with any web application, Verdaccio has a customizable built-in logger. You can define multiple types of outputs.

# console output
log: { type: stdout, format: pretty, level: http }

or file output.

# file output
log: { type: file, path: verdaccio.log, level: info }

Verdaccio 5 does not support rotation file anymore, here more details.

Use SIGUSR2 to notify the application, the log-file was rotated and it needs to reopen it. Note: Rotating log stream is not supported in cluster mode. See here

Sensitive data can be masked or removed using log redaction.

log:
  type: stdout
  format: pretty
  level: http
  redact:
    paths:
      [
        'req.header.authorization',
        'req.header.cookie',
        'req.remoteAddress',
        'req.remotePort',
        'ip',
        'remoteIP',
        'user',
        'msg',
      ]
    censor: '<redacted>'

Configuration

Property	Type	Required	Example	Support	Description
type	string	No	[stdout, file]	all	define the output
path	string	No	verdaccio.log	all	if type is file, define the location of that file
format	string	No	[pretty, pretty-timestamped]	all	output format
level	string	No	[fatal, error, warn, info, http, debug, trace]	all	verbose level
colors	boolean	No	false	all	disable or enable colors
redact	object	No	see above		redact sensitive data
sync	boolean	No	true		turn on synchronous logging

Configuration​

Configuration