Skip to main content

Command Reference

Complete reference for all QuikDB CLI commands.

Basic Commands​

Get Help​

quikdb help
quikdb --help

# Get help for specific commands
quikdb device --help
quikdb service --help

Check Version​

quikdb --version

Update Commands​

Check for Updates​

# Check if updates are available
quikdb update --check

# Check with different channel
quikdb update --check --channel beta

Install Updates​

# Interactive update
quikdb update

# Force update without confirmation
quikdb update --force

# Update to beta releases
quikdb update --channel beta

The update system preserves your configuration and automatically backs up the current binary.

Device Commands​

Register Your Device​

quikdb device register

Register this device with the QuikDB network. Prompts for device details (name, country, location).

Check Device Status​

quikdb device status

Shows device registration status, connection state, and current earning information.

Refresh Authentication Tokens​

quikdb device refresh

Manually refresh authentication tokens for this device.

quikdb device link

Link this device to your user wallet using a one-time token from the web dashboard.

How to get a link token:

  1. Visit https://nodes.quikdb.com/devices
  2. Generate a link token
  3. Run quikdb device link and enter the token

Secure Existing Deployments​

quikdb device secure-deployments

Fix file permissions on existing deployment directories for enhanced security (sets to owner-only mode 0700).

Heartbeat Service Control​

Start the heartbeat monitoring service:

quikdb device heartbeat start

Stop the heartbeat service:

quikdb device heartbeat stop

Check heartbeat service status:

quikdb device heartbeat status

The heartbeat service sends regular updates to the QuikDB network to maintain your device's uptime score.

Auto-Start Service Commands​

# Install auto-start (runs on boot)
quikdb service install

# Check status
quikdb service status

# Uninstall
quikdb service uninstall

Works on macOS, Linux, and Windows.

Uninstall Commands​

Complete Removal​

# Preview what will be removed
quikdb uninstall --dry-run

# Remove QuikDB completely
quikdb uninstall

# Skip confirmation prompts
quikdb uninstall --force

Preserve Data​

# Keep your registration data
quikdb uninstall --keep-config

# Keep log files for troubleshooting
quikdb uninstall --keep-logs

# Combine options
quikdb uninstall --keep-config --keep-logs

The uninstall command safely removes:

  • All running QuikDB processes
  • Auto-start services
  • Configuration files (unless --keep-config)
  • Platform-specific service files

Tunnel Commands​

Check tunnel status:

quikdb device tunnel status

Request/allocate a new Cloudflare tunnel:

quikdb device tunnel request

Reconfigure an existing tunnel:

quikdb device tunnel reconfigure

Updates the configuration for your device's Cloudflare tunnel.

Referral Commands​

Generate Your Code​

quikdb referral generate

View Referral Stats​

quikdb referral status

Apply a Referral Code​

During registration:

quikdb device register --referral-code CODE

After registration:

quikdb referral apply CODE

See the Referral System Guide for details.

Web Dashboard​

Open http://localhost:4222 to see:

  • Connection status and uptime
  • Earnings and ranking
  • Live system metrics

Uptime persists across restarts.

Common Usage​

Setup:

quikdb device register
quikdb service install

Check status:

quikdb device status

Restart if needed:

quikdb device heartbeat stop
quikdb device heartbeat start