Why Static Files Fail in Vagrant + VirtualBox and How to Disable Sendfile

In the previous article we introduced building a development environment with Windows, Vagrant, and VirtualBox, offering a lightweight, OS‑agnostic solution that many developers prefer over Docker.

However, when updating files inside the virtual machine you may notice that static assets do not reflect the changes in the browser, or JavaScript files throw errors showing garbled characters like "����".

This behavior is caused by a VirtualBox bug that requires disabling the sendfile feature in both Nginx and Apache. The Apache documentation explains the EnableSendfile directive:

The EnableSendfile directive controls whether httpd can use the kernel's sendfile support to transfer file contents to the client. By default, when a request does not need to read file data—such as serving static files—Apache uses sendfile if the operating system supports it. This mechanism avoids separate read and write operations and buffer allocation, but on some platforms or file systems it is advisable to disable it to avoid operational problems, including corrupted files or unexpected characters.

Because sendfile is a high‑performance system call that reduces context switches and data copies, it should be turned off in a VirtualBox environment. The required configuration changes are:

For Nginx as the web server, edit nginx.conf and set sendfile off; For Apache as the web server, edit httpd.conf and set EnableSendfile Off Note that when Nginx serves static files directly, enabling sendfile improves performance, but when Nginx acts as a reverse proxy the input file descriptor is a socket, making sendfile ineffective. Therefore, in a VirtualBox setup where Nginx is used as a reverse proxy and Apache serves the files, disabling EnableSendfile in Apache resolves the static‑file corruption issue.

References:

https://www.vagrantup.com/docs/synced-folders/virtualbox.html

https://github.com/hashicorp/vagrant/issues/351

http://httpd.apache.org/docs/2.2/mod/core.html#enablesendfile