Back to Documentation

Troubleshooting

Common issues and solutions for ProxMan.

Connection Issues

Cannot Connect to Server

Problem: Unable to connect to Proxmox server

Solutions:

1. Verify Server Details

- Check IP address/hostname is correct

- Verify port number (default: 8006)

- Ensure server is powered on and accessible

2. Check Network Connectivity

- Ensure your mobile device has internet/network access

- Verify you're on the same network or have VPN access

- Test connection from another device

3. Firewall Settings

- Check Proxmox firewall allows port 8006

- Verify network firewall rules

- Ensure no blocking at router level

Authentication Failed

Problem: Login credentials rejected

Solutions:

1. Verify Credentials

- Check username format: username@pam or username@pve

- Verify password is correct

- Try logging in via Proxmox web interface

2. User Permissions

- Ensure user has appropriate permissions

- Check user is not disabled

- Verify realm is correct (PAM vs PVE)

Connection Timeout

Problem: Connection times out

Solutions:

1. Network Issues

- Check network stability

- Try different network (WiFi vs cellular)

- Verify no proxy blocking connection

2. Server Load

- Server may be overloaded

- Check server status via Proxmox web interface

- Wait and retry

Notification Issues

Not Receiving Notifications

Problem: Push notifications not working

Solutions:

1. System Permissions

- Check notification permissions in system Settings

- Verify ProxMan is allowed to send notifications

- Enable badges and sounds

2. App Settings

- Ensure notifications enabled in ProxMan

- Check notification types are enabled

- Verify server connection is active

3. Network Issues

- Check internet connectivity

- Verify notification service is reachable

- Try different network

Too Many Notifications

Problem: Receiving excessive notifications

Solutions:

1. Manage ProxMan Webhook

- Go to Proxmox web interface → Datacenter → Notifications

- On Notification Targets modify proxman-matcher

- Match rules → Change settings accordingly

App Crashes

App Crashes on Launch

Problem: App crashes when opening

Solutions:

1. Reinstall App

- Delete and reinstall ProxMan

- Restore from backup if available

- Reconfigure servers

2. Device Issues

- Update OS to latest version

- Restart device

3. Data Corruption

- Clear app data

- Reset app settings

- Start fresh

App Crashes During Use

Problem: App crashes randomly

Solutions:

1. Update App

- Check for app updates

- Install latest version

2. Report Bug

- Note what you were doing

- Contact support with details

Getting Help

Support Resources

  • FAQ: Check FAQ page for common questions
  • Email Support: [email protected]
  • App Store / Google Play: Leave review
  • Documentation: Review all documentation pages

Reporting Bugs

When reporting issues, include:

  • OS version
  • ProxMan version
  • Proxmox version
  • Steps to reproduce
  • Error messages
  • Screenshots if applicable

Feature Requests

Submit feature requests:

Next Steps

Was this page helpful? Contact Support