1. Requirements
- Windows 10 version 21H2 or newer, or Windows 11.
- 64-bit x64 processor, 4 GB RAM minimum, and around 200 MB free disk space.
- Internet access for downloads, update checks, network-dependent diagnostics, and optional app installation.
- Some system features require administrator approval. See the Permissions Guide.
2. Download and install
- Visit the latest official CoreX release.
- Download the Windows setup file attached to the release. Check that the file comes from the official Noveriks/CoreX repository.
- Open the downloaded installer. If SmartScreen, antivirus, or UAC shows a warning, pause and confirm the publisher/source and that you intended to run this file. Cancel if unsure.
- Follow the setup prompts. The installer can create Start menu and desktop shortcuts and lets you choose an install folder.
- Launch CoreX from the Start menu or shortcut.
3. First launch
Allow the dashboard to load. Some metrics depend on hardware and drivers, so unsupported readings may appear blank. CoreX does not need an administrator prompt for every viewing task; a prompt may appear when you invoke a protected system operation.
Before changing Windows settings, read the feature description and back up important files. A restore point can help with some system changes, but is not a personal-file backup.
4. Updating CoreX
CoreX may check GitHub Releases for a newer app version. You can also visit the release history yourself. Read release notes, download only from the official project, and close CoreX before running a replacement installer if requested.
Do not install a build merely because it is newer if its source is unclear. If a release appears damaged or unexpected, report it through GitHub Issues.
5. Portable build
The project configuration defines a Windows portable build target, but availability can vary by release. Use a portable executable only when that specific file is attached to an official release and its release notes identify it. Portable mode does not necessarily mean the app leaves no data on the PC; local logs or settings may still be written.
6. Build from source
For developers, the repository README lists pnpm as the recommended package manager. From a Windows development environment with Git, Node.js, and pnpm available:
git clone https://github.com/Noveriks/CoreX.git
cd CoreX
pnpm install
pnpm start
Use pnpm build to create the configured Windows NSIS installer. The repository also defines a pnpm build:portable command. Build output and signing depend on the maintainer's Windows environment and signing setup. Review the repository README and scripts before building or redistributing.
7. Uninstall and local app data
Uninstall CoreX from Windows Settings → Apps → Installed apps, or use its uninstaller if present. The project's installer configuration does not automatically delete app data on uninstall. Logs and settings may therefore remain in your Windows user profile. Keep logs if you need to troubleshoot; remove remaining app data manually only if you understand that this permanently deletes it.
Uninstalling CoreX does not necessarily revert every Windows tweak, DNS change, installed third-party app, or system setting. Revert settings individually where supported, or use Windows recovery options if necessary. See the User Guide before applying or reverting changes.
8. Troubleshooting install or launch issues
- Installer will not open: confirm the download completed, Windows meets the requirement, and your security software has not quarantined it. Re-download only from the official release page.
- Windows blocks it: check the source and publisher; do not disable security protection simply to force an install.
- App does not start: restart Windows, check the logs if available, and report the CoreX version, Windows version, and error message. Redact private data from logs.
- Need help: open an issue at GitHub Issues or email help.mahinulislam@gmail.com.