System tray
Coduva runs with an icon in the notification area of the Windows taskbar (the system tray). The menu layout is split in two, so it will feel familiar to WampServer users: left-click manages the services, and right-click manages the application.
Running in the background
- When you close the window (with the close button in the title bar), Coduva and the running services do not stop; Coduva keeps running in the tray. You reopen the window with Open control center in the tray menu.
- Coduva runs as a single instance. Starting Coduva again while it is already open does not open a second copy.
- When Coduva opens again, it recognizes the Nginx, PHP, and MariaDB processes that were started earlier and are still running.
Left-click: services menu
| Item | Function |
|---|---|
Coduva <version> | Heading |
| Open control center | Opens the window |
| Localhost | Opens the default site (http://localhost/) in the browser. Enabled while Nginx is running |
| phpMyAdmin | Opens phpMyAdmin with automatic login. Enabled while Nginx is running and phpMyAdmin is installed |
| Projects | Submenu: each project as name — address; the clicked project opens in the browser. Below it, Manage projects… opens the Projects screen. If there are no projects, No projects yet is shown |
| Nginx <version>: <status> | Submenu: Start, Stop, Restart, Open nginx.conf, Error log |
| PHP <version>: <n>/4 FastCGI processes | Submenu: Active version: <version>, Open php.ini, Error log |
| MariaDB <version>: <status> | Submenu: Start, Stop, Restart, Open my.ini, Error log |
| Services | Section heading |
| Start all services | Starts Nginx, the PHP pools, and MariaDB |
| Stop all services | Stops all of them |
| Restart all services | Restarts all of them |
The heading of the Nginx and MariaDB submenus shows the service version and its current status, for example Nginx 1.30.6: Running. The statuses are Running, Stopped, Not installed, Port <n> in use, and Port <n> blocked. Only the actions that make sense for that status are enabled: Start for a stopped service, and Stop and Restart for a running one.
The heading of the PHP submenu shows the pool of the default PHP version: while Nginx is running, PHP 8.4: 4/4 FastCGI processes; while it is stopped, PHP 8.4. If PHP is not installed, it shows PHP: Not installed; if none of the installed versions is supported, it shows PHP: no supported version.
Service actions run in the background. While an action is in progress, the icon's tooltip reads "Coduva · working…". If an action fails, the Coduva window opens on the Control center and the reason is shown in a notification balloon.
Configuration files
The nginx.conf, php.ini, and my.ini files are generated from templates by Coduva. They are rewritten when a service starts, when projects or PHP settings change, and when Coduva is updated; manual changes you make to them do not persist. Opening the files is for inspection; make lasting changes from the interface. See Directories and files.
Right-click: application menu
| Item | Function |
|---|---|
Coduva <version> · Started: <time> | Heading |
| Open control center | Opens the window |
| Settings | Opens the Settings screen |
| Go to | Submenu: Projects, PHP and Node, Local domains, Database, Diagnostics |
| Folders | Submenu: Component folder, Default site (www\localhost), Service logs, App data. Folders that do not exist yet are disabled |
| Language | Submenu: Türkçe, English |
| Tools | Submenu: Diagnostics, Install components… (opens the Control center), Event log (opens the Settings screen) |
| Help | Submenu: coduva.dev (opens the site in the browser), About (opens the Settings screen) |
| Start with Windows | Checked or unchecked option |
| Refresh | Refreshes the menu and statuses |
| Stop services and quit | Stops all services, then closes Coduva |
| Quit | Closes Coduva; Nginx, PHP, and MariaDB keep running |
Quitting and project processes
When you quit Coduva, project processes (queue worker, scheduler, Vite) are stopped in both cases. Services are shut down only by Stop services and quit.
Status colors
| Color | Meaning |
|---|---|
| Green | All installed services are running |
| Gray | Services are stopped or not installed |
| Red | There is a port conflict or a blocked port |
Hovering over the icon opens a tooltip with three lines: the Nginx version and status, the PHP pool, and the MariaDB version and status. The menu and the tooltip refresh automatically every few seconds.
Starting with Windows
When Start with Windows is on, Coduva starts only in the tray, without showing a window, when you sign in. The option can be turned on or off in two places: the tray's right-click menu and Settings → General.
Technically, Coduva writes its own path with the --hidden argument to the HKCU\Software\Microsoft\Windows\CurrentVersion\Run key in the user registry. No administrator permission is required.
Development build
If you run Coduva from source in development mode and turn this option on, the entry points to target\debug\coduva.exe. Turn it off after testing; the version from the installer writes its own path.
Language
The tray menu is built when Coduva opens. When you change the language from the Language submenu, the Settings screen, the language button in the status bar, or the command palette, the interface changes immediately; the text of the tray menu switches the next time Coduva is opened.