Troubleshooting

Common issues and how to fix them.

---

Terminal not connecting?

Make sure tmux mouse mode is enabled:

tmux set -g mouse on

The bootstrap script does this automatically. If you skipped bootstrap, run it again.

---

Port already in use?

The default port is 8420. Pick a different one with:

lumbergh -p 9000

Note

In dev mode, the backend runs on port 8420 and the Vite frontend on 5420.

---

Dependencies not installing?

Run ./bootstrap.sh again -- it tells you what's missing.

For Node issues, make sure nvm is loaded first:

source ~/.nvm/nvm.sh

---

Session shows as inactive?

The session's tmux session may have been killed externally. Click Reset on the session card to restart it.

---

Git diff not updating?

• Make sure the session's working directory is a valid git repository.
• Check that git is installed and accessible from the shell.
• Diffs are cached in the background every 5 seconds. If you just made a change, wait a moment for the cache to refresh.

---

Locked out after setting a password?

If you set a password and can't log in:

1. Stop Lumbergh
2. Edit ~/.config/lumbergh/settings.json and clear the "password" field (set it to "")
3. Restart Lumbergh

Alternatively, unset the LUMBERGH_PASSWORD environment variable if that's how you configured it.

---

AI status not working?

Configure an AI provider in Settings > AI tab.

For Ollama, make sure the server is running:

ollama serve

---

Mobile can't connect?

Lumbergh binds to 0.0.0.0 by default, so it should be accessible from any device on your local network. If it's not:

• Check your firewall rules (e.g., ufw, iptables).
• For remote access outside your LAN, use Tailscale.

---

PWA not installable?

PWA installation requires HTTPS. Use Tailscale Serve for automatic TLS certificates:

tailscale serve --bg 8420