- How do I install Valet Linux on Ubuntu?
- Install it globally with composer global require cpriego/valet-linux, then run valet install. The installer configures Nginx, PHP-FPM, DnsMasq, a systemd service, sudoers rules, and a local CA in the system trust store. You will need sudo and a Debian or Ubuntu-family system for the smoothest experience.
- Does cpriego/valet-linux support Laravel 11 and Laravel 12?
- Valet Linux is host tooling rather than a Laravel package dependency, so it is not tied to a Laravel app version in composer.json. It serves whatever PHP project you link or park, provided your installed PHP and Nginx configuration are compatible. Because the project tracks upstream Laravel Valet with some lag, newer PHP versions and distro releases may need manual fixes.
- What is cpriego/valet-linux used for?
- It is a Linux port of Laravel Valet for serving local PHP and Laravel sites with Nginx, PHP-FPM, and DnsMasq. Developers use valet link or valet park to expose projects at https://project.test without Vagrant or Docker. It is intended as a lightweight local development convenience, not an application dependency.
- Why does Valet Linux fail with systemd-resolved or break DNS?
- Valet Linux configures DnsMasq to resolve .test domains locally, which can conflict with systemd-resolved's stub listener on 127.0.0.53. That conflict is one of the most common installation failures and can make host networking appear broken. You need to adjust or disable the stub listener according to your distro before expecting valet install to succeed cleanly.
- Is Valet Linux safe to use in production or CI?
- No. Valet Linux is a host-level developer tool that mutates your workstation by installing services, editing sudoers, and adding a generated CA to the system trust store. It offers no reproducibility guarantee, lockfile, or parity with CI and staging. Use Sail, Docker Compose, Devcontainers, or your production stack for CI and production workflows.
- How is Valet Linux different from Laravel Herd or Laravel Sail?
- Valet Linux is a community fork of Laravel Valet adapted for Linux hosts, while Laravel Herd is the first-party commercially backed option that now covers Linux. Sail and Docker Compose provide project-level containerized environments with better CI parity. Valet Linux sits between them as a native host convenience tool with a shrinking niche.
- Do I need sudo to install and use Valet Linux?
- Yes, installation requires sudo because it installs and configures Nginx, DnsMasq, PHP-FPM, a systemd service, a sudoers drop-in, and a local CA in the system trust store. Many corporate-managed laptops restrict these changes or flag sudoers and trust-store edits. Check with IT or endpoint security before adopting it as a standard tool.
- Why does cpriego/valet-linux have zero dependents on Packagist?
- That is expected because Valet Linux is not an application dependency and should never be required in a project's composer.json. It is installed globally as developer tooling with composer global require. Zero dependents does not indicate a problem with the package itself.
- Can I use Valet Linux with Docker, WSL2, or GitHub Codespaces?
- Valet Linux is designed for native Linux host serving and has no meaningful support for containers, WSL2 remote workflows, or ephemeral cloud environments such as Codespaces, Coder, or Gitpod. It also conflicts with Docker setups that need ports 80 and 443 or that manage DNS for .test domains. Use container-native tooling for those environments instead.
- Is cpriego/valet-linux actively maintained and which Linux distros are supported?
- It is a single-maintainer project with a bus-factor risk and historically low activity, tracking upstream Laravel Valet with a lag. Support is realistically Ubuntu and Debian-centric, while Arch, Fedora, and openSUSE usage is community-grade and version-fragile. Before standardizing, verify that your pinned version still receives parity fixes and that your fleet's distro versions are covered.