Skip to content

Manage Global Uplinkr Settings

Terminal window
php artisan uplinkr:settings

Manages global Uplinkr settings stored in storage/app/private/uplinkr/settings.json.

Currently, this command configures the global I’m alive feature:

  • enable/disable heartbeat notifications
  • configure interval in hours (1-24)
  • configure channels (mail, log, webhook)

When called without options, it prints the current configuration.

OptionTypeRequiredDefaultDescription
--iam-alive-enabledbooleanNounchangedEnable or disable I’m alive (true/false)
--iam-alive-interval-hoursintegerNounchangedInterval in hours (1-24)
--iam-alive-channelsstringNounchangedComma-separated channels (mail,log,webhook)
--forceflagNofalseSkip confirmation prompt
Terminal window
php artisan uplinkr:settings
Terminal window
php artisan uplinkr:settings \
--iam-alive-enabled=true \
--iam-alive-interval-hours=6 \
--iam-alive-channels=mail,log \
--force
Terminal window
php artisan uplinkr:settings --iam-alive-enabled=false --force
Terminal window
php artisan uplinkr:settings \
--iam-alive-interval-hours=12 \
--iam-alive-channels=webhook \
--force

If only interval/channels are provided (without --iam-alive-enabled), Uplinkr enables I’m alive automatically.

  • Reads and writes global settings in storage/app/private/uplinkr/settings.json
  • Validates interval range (1-24) and channels (mail, log, webhook)
  • Asks for confirmation unless --force is provided
  • Prints updated values including last_sent_at
  • last_sent_at represents the last successful heartbeat delivery; internal scheduler retry state is handled separately
  • 0 (SUCCESS): Settings were shown or updated successfully
  • 2 (INVALID): Validation failed or process was aborted