Troubleshooting

The app says the service is not running

The background service does the actual backups; the app is a front end for it.

• Windows - the service is Nyx Backup Service (NyxBackupSvc). Reopen the app; if it still cannot connect, restart the service from Services, or reboot.
• macOS / Linux - the service runs under launchd / systemd and starts at login or boot. Relaunch the app; if it persists, restart the machine.

Test connection fails

• Double-check the bucket or container name, region or endpoint URL, and the access key and secret. A key scoped to a different bucket will fail here.
• For SFTP, confirm the host, port, username, and that the private key or password is correct and the remote path exists.
• Confirm the account has permission to list and write objects, not just read.
• If it reports the bucket does not exist, let Nyx Backup create it, or create it in your provider’s console and test again.

Windows: backups are slow or Defender is busy

Real-time antivirus scanning every file Nyx Backup reads slows backups down. The app can check whether the recommended Windows Defender exclusions are in place - see the status in Settings - and guide you through adding them. This is safe: the exclusion only stops Defender from re-scanning files Nyx Backup is already reading for backup.

macOS: some files are skipped

macOS protects certain folders behind Full Disk Access. If backups miss files under protected locations, grant Nyx Backup Full Disk Access in System Settings > Privacy and Security. The app shows whether access is granted.

Backups feel too aggressive (or too slow)

Each set has a priority. Background priority yields to your other work and is gentler on a busy machine but slower; normal priority backs up at full speed. Performance tuning (chunk sizes, workers, compression) is automatic by default - leave it there unless you have a measured reason to change it.

Where the logs are

If you need to dig in or send details to support, the logs are here:

• Windows - C:\ProgramData\NyxBackup\logs\
• macOS - /var/log/nyxbackup/ (service) and ~/Library/Logs/NyxBackup/
• Linux - /var/log/nyxbackup/ (service) and ~/.local/share/nyxbackup/logs/

Still stuck

Search these docs, ask the in-app assistant, or email support@nyxbackup.com. A clear description of what you did, what you expected, and the exact message you saw gets you the fastest answer.