Command not found
- Run the same command from Terminal in the project folder.
- Confirm the required tool and project dependencies are installed.
- Confirm the command is available to zsh, not only to an interactive shell profile.
- Open project Logs to inspect the complete error.
Workspace keeps waiting
The configured local URL does not respond yet. Confirm it matches the actual protocol, hostname, and port printed by the process.
Port already in use
Another process is listening on the configured port. Cancel and stop it manually when the owner is MAMP, Docker, a database, or a system service.
If the development server automatically chooses another port, update the project's local URL so Localdeck opens the correct address next time.
MAMP or MAMP PRO does not start
Localdeck can open MAMP PRO but cannot reliably press its Start button. Start its servers manually before using custom MAMP hostnames.
Standard MAMP can use its shell scripts, but detached external services do not provide the same managed running state as attached development commands.
Device Preview does not load
- Confirm the local service itself works on the Mac.
- Confirm the testing device is on the same network.
- Allow Localdeck through the macOS firewall.
- Add separate local backend or CMS URLs as linked URLs.
- Refresh preview status after starting or restarting services.
Update check fails
Update checks require the packaged Localdeck app. Development builds started with swift run do not contain the complete signed update configuration.
Report a problem
Open Settings and use Report bug. Include the Localdeck version, macOS version, expected result, actual result, and reproducible steps. Remove private project data before sending logs or screenshots.