Skip to main content

Troubleshooting

Authentication Issues​

Problem: Cannot authenticate, login fails, or session expires.

# Clear stored credentials and re-authenticate
boltic logout
boltic login

# If browser doesn't open automatically, copy the manual URL displayed
boltic login

# Check network connectivity
ping console.fynd.com

Notes:

  • The authentication flow has a 5-minute timeout — retry if it expires.
  • Supported browsers: Chrome, Firefox, Safari, Edge.

Integration Issues​

Problem: Cannot create, edit, sync, or submit integrations.

# Check status
boltic integration status

# Force sync
boltic integration sync

# Pull latest from Boltic Cloud
boltic integration pull

# Verify you're in the correct directory (should contain spec.json)
ls -la

# Re-authenticate
boltic logout && boltic login

Network and Connectivity Issues​

Problem: Connection errors, timeouts, or API failures.

# Test basic connectivity
ping console.fynd.com

# Use verbose mode for detailed error output
boltic --verbose integration sync
boltic --verbose login

File and Directory Issues​

Problem: Missing files, permission errors, or corrupted project structure.

# Verify integration project structure
ls -la  # Should show: schemas/, documentation/, spec.json

# Check file permissions
ls -la schemas/

Performance and Sync Issues​

Problem: Slow performance, hanging operations, or sync failures.

# Check status first
boltic integration status

# Verbose sync
boltic --verbose integration sync

# Clear cache and re-authenticate
boltic logout
boltic login

Debug Mode​

Enable verbose logging for any command:

boltic --verbose <command>

# Examples
boltic --verbose integration create
boltic --verbose integration sync
boltic --verbose serverless publish

Environment Issues​

# Check Node.js version (requires 18.0.0+)
node --version

# Check npm version (requires 8.0.0+)
npm --version

# Update CLI to latest
npm install -g @boltic/cli@latest

# Verify installation
boltic version

Emergency Recovery​

If all else fails, do a complete reset:

boltic logout
npm uninstall -g @boltic/cli
npm install -g @boltic/cli
boltic login

Getting Help​

# Built-in help
boltic help
boltic integration help
boltic serverless help

External resources: