CudoMiner Folder Structure — Every File & Location Explained
A complete map of every file and directory CudoMiner creates on Windows, Mac and Linux — with what each file does, which are safe to delete, and which are managed automatically.
File Locations by Platform
CudoMiner Folder Structure — Windows, Mac & Linux
User data rootC:\Users\[YourName]\AppData\Roaming\CudoMiner\
Press Win+R, type %APPDATA%\CudoMiner and press Enter to open this folder directly in Windows Explorer.
User data root~/Library/Application Support/CudoMiner/
~/Library/Application Support/CudoMiner/
├── cache/— UI render cache. Safe to delete.
├── logs/— Session logs, one per day.
│ └── cudominer-2026-05-20.log
├── plugins/— Algorithm plugins. Auto-managed.
│ ├── autolykos2/— Ergo algorithm plugin
│ └── kawpow/— RVN plugin
└── config/— Local device config.
💡
Open Terminal and run open ~/Library/Application\ Support/CudoMiner to access this folder in Finder.
User data root~/.cudominer/
~/.cudominer/
├── cache/— UI render cache. Safe to delete.
├── logs/— Session logs.
│ └── cudominer-2026-05-20.log
├── plugins/— Algorithm plugins.
│ ├── kawpow/
│ ├── autolykos2/
│ ├── randomx/— Best for Linux CPU mining
│ └── etcminer/
└── config/— device-config.json
💡
Run ls -la ~/.cudominer/ in Terminal to list all contents including hidden subdirectories.
File-by-File Reference
What Every CudoMiner File Does
📋
cudominer-[date].log
logs/ folder on all platforms
Daily session log containing GPU detection events, algorithm switches, pool connections, hashrate readings, temperature warnings, error messages and plugin load events. Essential for diagnosing problems. Readable in any text editor.
Electron renderer cache, GPU benchmark results and temporary UI assets. Completely safe to delete at any time — CudoMiner rebuilds it automatically. Deleting this folder is the first step in fixing blank screen and rendering issues.
Safe to delete
🔌
plugins/ folder
All platforms — contains one subdirectory per algorithm
Algorithm plugin binaries downloaded and managed automatically by CudoMiner. Each subfolder is a separate miner binary (kawpow, autolykos2, randomx, etcminer, etc.) with its own version file. Do not edit or delete plugin files manually — CudoMiner will re-download or refuse to start.
Auto-managed
⚙
device-config.json
config/ folder on all platforms
Local device-specific settings: idle detection threshold (seconds), GPU temperature limit, power cap, and display preferences. These settings are not synced to the server — they apply only to this machine. Editing this JSON directly is possible for advanced users but not recommended; use the Settings panel instead.
Local only
🔄
update-manifest.json
%APPDATA%\CudoMiner\ root (Windows)
Plugin version registry used by CudoMiner to check whether installed plugins are current. On each launch, CudoMiner compares this manifest against the server version list and downloads updates for any outdated plugins. Do not edit this file.
Auto-managed
Reading Logs
How to Read CudoMiner Log Files
CudoMiner log files are plain text, readable in any editor (Notepad, VS Code, nano). Each line is timestamped and prefixed with a severity level:
Log format: [TIMESTAMP] [LEVEL] [MODULE] Message[2026-05-20 09:12:44] INFO [GPU] NVIDIA RTX 4070 detected — VRAM: 12288 MB[2026-05-20 09:12:45] INFO [PLUGIN] Loading kawpow v2.3.1 plugin[2026-05-20 09:12:47] INFO [MINING] Connected to pool: kawpow.pool.cudominer.com:3333[2026-05-20 09:14:03] INFO [SWITCH] Switching to autolykos2 — higher profitability detected[2026-05-20 09:14:05] INFO [OC] Applying Ergo OC profile: mem+900 core+150 PL80%[2026-05-20 09:22:11] WARN [TEMP] GPU temp 78°C — approaching limit (80°C)[2026-05-20 09:22:14] WARN [TEMP] Throttling hashrate to reduce temperature
🔍
Diagnosing problems: Search log files for ERROR or WARN to find issues. Common entries: GPU not detected (driver issue), Pool connection failed (network/firewall), Plugin load failed (corrupted plugin — delete the plugins/ folder to force re-download).
FAQ
Folder Structure FAQ
Where is CudoMiner installed on Windows?
The CudoMiner executable and application files are installed at C:\Users\[YourName]\AppData\Local\Programs\CudoMiner by default (or C:\Program Files\CudoMiner if installed for all users). User data — including logs, plugins, config and cache — is stored separately at C:\Users\[YourName]\AppData\Roaming\CudoMiner.
Where are CudoMiner log files stored?
On Windows, CudoMiner log files are at C:\Users\[YourName]\AppData\Roaming\CudoMiner\logs\. Each session creates a timestamped log file (e.g. cudominer-2026-05-20.log). On Linux, logs are at ~/.cudominer/logs/. On Mac, logs are at ~/Library/Application Support/CudoMiner/logs/. Logs contain mining events, GPU detection, algorithm switches and any errors.
Can I safely delete the CudoMiner cache folder?
Yes. The cache folder at %APPDATA%\CudoMiner\cache (Windows) or ~/.cudominer/cache (Linux) contains temporary rendering data and benchmark caches. Deleting it is completely safe — CudoMiner rebuilds it automatically on next launch. Your account data, Vault balance, Markdown notes and wallet addresses are stored server-side and are unaffected.
Where are CudoMiner plugins stored?
CudoMiner algorithm plugins are stored at %APPDATA%\CudoMiner\plugins\ on Windows, at ~/.cudominer/plugins/ on Linux, and at ~/Library/Application Support/CudoMiner/plugins/ on Mac. Each plugin is a subdirectory named after the algorithm (e.g. kawpow, autolykos2, randomx). Do not manually edit plugin files — CudoMiner manages them automatically.