Jose Jimenez
Jose Jimenez
Software Architect & Developer
> >

Resolving Laravel Homestead Vagrant 'Up' Issues on macOS: Full Disk Access Required

Published in macOS, Laravel Homestead, Vagrant on Jun 12, 2024

When using Vagrant on macOS, you may encounter issues with mounting shared folders, particularly if your terminal does not have the necessary administrative privileges. This can manifest in errors during the vagrant up process, such as the following:

1→ homestead: Exporting NFS shared folders...
2→ homestead: Preparing to edit /etc/exports. Administrator privileges will be required...
4Could not kickstart service "": 1: Operation not permitted
5/bin/launchctl exited with status 1
6→ homestead: Mounting NFS shared folders...
7The following SSH command responded with a non-zero exit status.
8Vagrant assumes that this means the command failed!
9mount -o vers=3, actimeo=1, nolock /var/www
10Stdout from the command:
11Stderr from the command:
12mount.nfs: an incorrect mount option was specified

This error typically indicates that your terminal lacks the necessary permissions to execute certain operations, such as modifying /etc/exports and managing NFS services. Fortunately, you can resolve this issue by granting your terminal full disk access. Follow the steps below to fix this problem.

Step-by-Step Guide to Grant Full Disk Access to Your Terminal

  1. Open System Settings:

    • Click on the Apple menu in the top-left corner of your screen.
    • Select System Settings.
  2. Navigate to Privacy & Security:

    • In the System Settings window, scroll down and click on Privacy & Security.
  3. Locate Full Disk Access:

    • In the Privacy & Security section, find and click on Full Disk Access.
  4. Add Your Preferred Terminal:

    • Click the + button to add a new application.
    • Navigate to the terminal application you use to run Vagrant (for example, Terminal, iTerm2, etc.).
    • Select the terminal application and click Open.
  5. Enable Full Disk Access:

    • Ensure that the terminal application you just added is enabled. You should see a toggle switch next to it, which should be turned on.
  6. Restart Your Terminal:

    • Close the terminal application completely.
    • Reopen the terminal application.

By following these steps, you grant your terminal the necessary permissions to perform administrative tasks required by Vagrant. This should resolve the mounting issues and prevent the following errors from occurring:

  • Could not kickstart service "": 1: Operation not permitted
  • mount.nfs: an incorrect mount option was specified


Granting your terminal full disk access is a straightforward solution to resolve Vagrant mounting issues on macOS. This ensures that your terminal has the necessary privileges to modify system files and manage services, thereby allowing Vagrant to operate smoothly. After making these changes, you should be able to run vagrant up without encountering the previously mentioned errors.

For additional troubleshooting or further assistance, consider checking Vagrant's official documentation or community forums. Happy coding!