SDExplorer Base: Complete Setup & Quickstart Guide

SDExplorer Base: Troubleshooting Common Issues

1. Won’t start or crashes on launch

• Check system requirements: Ensure OS, CPU, RAM, and GPU meet the app’s minimums.
• Update software: Install the latest SDExplorer Base build and update GPU drivers.
• Run as administrator: On Windows, try running the app with elevated privileges.
• Check logs: Open the application log file (usually in the app folder or %APPDATA%) and scan for error messages or stack traces.
• Reinstall cleanly: Uninstall, remove leftover config folders, then reinstall.

2. High memory or GPU usage / slow performance

• Lower resource settings: Reduce batch size, image resolution, or number of concurrent jobs in preferences.
• Use CPU fallback: If GPU is unstable, switch to CPU processing temporarily.
• Close other apps: Free RAM and GPU VRAM by closing browsers, games, or other heavy software.
• Enable GPU optimizations: Turn on mixed precision (FP16) or other hardware acceleration if available.
• Monitor usage: Use Task Manager / nvidia-smi to identify leaks or runaway processes.

3. Model loading failures or “out of memory” errors

• Match model to VRAM: Use smaller models or offload parts to CPU if VRAM is insufficient.
• Use model sharding/CPU offload: Enable options that split model between GPU and system RAM.
• Clear cache: Delete cached model files and let the app re-download them.
• Increase virtual memory/swap: Temporarily increase paging file (Windows) or swap (Linux/macOS).

4. Plugin or extension problems

• Check compatibility: Ensure plugin versions match SDExplorer Base version.
• Disable/uninstall bad plugins: Start with plugins disabled, then enable one-by-one to find the culprit.
• Update plugins: Install the latest plugin releases from trusted sources.

5. Issues with inputs or outputs (corrupt images, failed saves)

• Verify file paths/permissions: Ensure the app has write permission to output folders.
• Supported formats: Confirm input images and export formats are supported; re-save problem files in a standard format (PNG/JPEG).
• Disk space: Ensure sufficient free disk space for temporary files and outputs.

6. Network, download, or update errors

• Check connectivity: Verify internet access and that no firewall/proxy blocks the app.
• Retry downloads: Temporary server issues may require repeated attempts.
• Use manual model install: If automatic download fails, place model files in the expected local directory per docs.

7. Unexpected artifacts or low-quality results

• Adjust prompts/settings: Refine prompts, increase sampling steps, or change sampler type.
• Seed and CFG: Test different seeds and classifier-free guidance (CFG) scales.
• Check model suitability: Some models specialize in styles—switch to a model suited for the target output.

8. Authentication or licensing errors

• Validate credentials: Re-enter API keys or license codes and ensure they haven’t expired.
• Time sync: Ensure system clock is accurate (required by some license checks).

9. Permission or access denied errors on startup

• Antivirus false positives: Temporarily whitelist SDExplorer Base or check quarantine.
• Folder permissions: Grant full control to the app folder for your user account.

10. Persistent unknown errors

• Collect diagnostics: Gather logs, system specs, screenshots, and reproduction steps.
• Search community/forums: Look for similar reports on official forums, GitHub issues, or Discord.
• Create a bug report: Submit logs and reproduction steps to the developers.

Quick troubleshooting checklist

1. Update app and drivers.
2. Lower resource settings or use smaller models.
3. Check logs and permissions.
4. Disable plugins and test.
5. Collect diagnostics and report if unresolved.

If you want, tell me your OS, GPU, SDExplorer Base version, and a copy of the error log and I’ll suggest targeted fixes.