System requirements
Summary
| Requirement | Value |
|---|---|
| Operating system | Windows 10 (22H2) or Windows 11 |
| Architecture | x64 |
| WebView2 runtime | Required; included with Windows 11 |
| Microsoft Visual C++ 2015–2022 (x64) | Required for PHP |
| Disk | Installer about 4 MB; components about 155 MB of downloads; additional space for projects and databases |
| Internet | When downloading components, when tools such as Composer or WP-CLI download packages, and for an update check at most once a day (can be turned off) |
| Administrator account | Not required; a UAC approval is requested for hosts changes |
macOS and Linux are not supported; they are not planned for the first year.
Windows version
Coduva runs on Windows 10 22H2 and Windows 11, on 64-bit (x64) systems. ARM-based Windows devices are not among the supported targets.
WebView2
Coduva's interface is drawn with Microsoft Edge WebView2. WebView2 is included with Windows 11 and with up-to-date Windows 10 installations. If it is missing, the installer downloads and installs WebView2 from Microsoft; this requires an internet connection during setup.
The installer (NSIS) is per-user and does not ask for administrator permission. The program is installed to the %LOCALAPPDATA%\Coduva folder.
Visual C++ runtime
PHP builds for Windows depend on the Microsoft Visual C++ 2015–2022 (x64) redistributable package. Coduva checks for it on the Diagnostics screen by looking for the vcruntime140.dll and vcruntime140_1.dll files. If they are missing, the check shows Error, and the Download Visual C++ action is offered.
A typical sign of a missing runtime is that PHP does not start at all, or the error PHP Startup: Unable to load dynamic library. See Diagnostics rules.
Disk space
The Install components action downloads the default components:
| Component | Download size |
|---|---|
| MariaDB 11.8.9 | ~97 MB |
| PHP 8.4.27 | ~35 MB |
| phpMyAdmin 5.2.3 | ~16 MB |
| WP-CLI 2.12.0 | ~7 MB |
| Composer 2.11.2 | ~4 MB |
| Nginx 1.30.6 | ~3 MB |
| CA certificate bundle | ~0.2 MB |
Optional components: PHP 8.3.36 (~34 MB), PHP 8.5.12 (~36 MB), Node.js 26.13.1 (~41 MB). After the zip files are extracted, they take up more space on disk than their download size.
Diagnostics shows a warning when the disk that holds the component folder has less than 2 GB of free space.
Internet connection
After the components are installed, Coduva works offline. An internet connection is needed in these cases:
- When installing components (Nginx, PHP, MariaDB, Composer, WP-CLI, phpMyAdmin, Node.js).
- When creating a new WordPress project (the WordPress core is downloaded).
- When creating a new Laravel project (
composer create-projectdownloads the packages). - When running commands in your project that download packages, such as
composer installornpm install. - For the update check: Coduva checks
updates.coduva.devfor a new version at most once a day. When you are offline, the check is skipped silently and retried after 6 hours. You can turn this check off from the Settings › Updates card; see Keeping Coduva up to date.
Components are downloaded only from their official sources. See Components.
Directory paths
Coduva installs its components to the C:\Coduva folder by default. This path is deliberately made up of ASCII characters and does not depend on your user name.
Paths with non-ASCII characters
PHP, Composer, and some other tools may have problems with paths that contain non-ASCII characters such as ç, ğ, ı, ö, ş, ü. When the component folder or an added project folder contains non-ASCII characters, Coduva shows a warning. Keep your projects in an ASCII path such as C:\Coduva\www or D:\projeler.
Other local servers
Coduva does not modify WampServer, XAMPP, or Laragon installations; it only detects them. If one of these programs is running, the warning "Another local server was detected" appears on the Control center screen; merely having them installed does not trigger the warning. When they run at the same time, ports 80 and 3306 can conflict. In that case, either stop the other program or change Coduva's ports. See Ports.
If IIS or the "World Wide Web Publishing Service" is enabled, port 80 is held by the Windows HTTP server (http.sys); Coduva also points this out.
Antivirus
Windows Defender's real-time protection can noticeably slow down PHP projects, especially projects with Composer and a vendor folder. Diagnostics reports this condition as Info. You may want to add the component folder (C:\Coduva) and your project folders to the Defender exclusion list.
Development environment (for building from source)
For those who want to build Coduva from source:
- Node.js 22 or later
- Rust (stable) and MSVC build tools
- WebView2 runtime