Docs Help

Troubleshooting

Problem	What to do
A project is missing from the sidebar	Add its parent folder in Settings → General → Project folders, or use + next to Projects.
"Port already in use"	Open Ports, find the port, press Stop. Or open the project's Overview and use Why it will not start.
Node or PHP version does not match	Use the fix button in the red box, or pick a version in Run & logs. Install another version from Installed tools.
Docker section is empty	Press Start Docker. Wait about 20 seconds. If Lokstack says Docker is not installed, install Docker Desktop or OrbStack, open it once, then press I installed it.
Services page asks to install Homebrew	Press Install Homebrew. Terminal opens and asks for your Mac password. When it finishes, the list unlocks by itself.
No output in Run & logs	Output shows only for apps Lokstack started. Press Restart in Lokstack on the process.
"Permission denied" when stopping	The program belongs to another user, such as a root-owned web server. Stop it from its own app or with administrator rights.
An AI tool does not show "lokstack"	Quit and reopen that tool, then press How to check and Test Lokstack's side. If the test passes, the problem is in the tool's own settings.
Phone cannot open the QR link	Check that the phone and the Mac are on the same Wi-Fi, and that the dev server listens on all addresses (host `0.0.0.0`).
Pro seems to be off	Open Lokstack Pro. If the trial ended, Pro needs a licence key. If you were offline for more than 14 days, connect and activate again.
I made a mistake in Git	Press Undo at the top of the Git tab, or open Time machine to restore a checkpoint.
An AI tool broke my project	Open Safety and press Go back on the version you saved before.

Still stuck? Choose Send feedback in the bottom-left menu, or the Feedback button in the top bar. It opens a form on lokstack.app where you can report a bug or an idea. You can also email support@lokstack.app.

Something unclear or missing? Tell us or write to support@lokstack.app.