Support

Get help with DataForeman through community resources, GitHub, and direct support.

GitHub Issues

Bugs & feature requests

Open Issue →

Community Discussions

Questions, ideas & help from users

Join Discussion →

Direct Support

Private or enterprise inquiries

Contact Form →

Self-Service Resources

Diagnostic Tools

DataForeman includes built-in diagnostic tools:

  • System Health Dashboard - Real-time system status
  • Performance Metrics - CPU, memory, and disk usage
  • Connection Status - Device connectivity monitoring
  • Log Viewer - Centralized log analysis
Common Installation Issues
  • Docker Permission Errors: Run ./fix-permissions.sh
  • Port Conflicts: Check .env file for port configuration
  • Memory Issues: Increase Docker memory allocation (8 GB recommended)
  • Database Won't Start: Verify volume permissions with docker compose ps
Connectivity Issues
  • Device Connection Fails: Check network connectivity and firewall rules
  • Authentication Errors: Verify device credentials
  • Timeout Issues: Adjust timeout values in device configuration
  • Protocol Errors: Check device address format and protocol settings
Performance Issues
  • Slow Dashboard: Check data retention settings and query complexity
  • High Memory Usage: Review poll frequencies and reduce if needed
  • Database Growth: Configure data retention policies in TimescaleDB
  • CPU Spikes: Monitor device poll rates and adjust intervals

Community Guidelines

Do

  • ✅ Search before posting
  • ✅ Provide clear logs
  • ✅ Remove sensitive data
  • ✅ Be respectful

Don't

  • ❌ Share passwords
  • ❌ Duplicate questions
  • ❌ Off-topic posts
  • ❌ Expect instant replies

Security Reporting

If you discover a security vulnerability:

  1. Do NOT open a public GitHub issue
  2. Report privately via:
  3. Allow time for responsible disclosure

Security reports are prioritized and addressed as quickly as possible.

Resources