2 FAQ and Troubleshooting

This chapter groups frequent questions into access, account, file, storage and runtime categories, each with judgment criteria and a direction to fix. For uncovered cases, collecting information as in the last section speeds up diagnosis significantly.

Access

Page won't open: confirm the device shares the subnet with your computer and the IP is right; then run lynxdrive-ctl status to see whether the service runs and the port probe passes. If the port changed while bookmarks stayed old, switch to the new port. Share link won't open: links work only inside the intranet — confirm the recipient's network; a port change invalidates old links, regenerate them; a stopped share dies immediately.

Accounts

Login fails: check username case and input method, confirm the account isn't disabled; after repeated failures ask the administrator to reset rather than guessing on. A directory is invisible: usually a permission scope issue, or you're in the wrong directory or logged in as another account — the administrator adjusts permissions.

Files

Upload fails or breaks: common causes are exhausted space (including a full external disk), missing upload permission, or the network dropping mid-transfer; check free capacity first, permissions second, then retry large files over wired network. Styles broken or buttons dead: hard-refresh first; if it persists, switch to a recent Chrome, Edge or Safari — old browsers degrade visually but stay functional.

Storage

External disk not recognized: check the interface and power, try another USB port or enclosure, and wait a dozen seconds after plugging in for detection and switchover; if the "external disk disconnected" notice file sits in the root, internal storage is still active. Low on space: clean in the order from the capacity chapter — never delete the sole copy first.

Runtime

Service keeps restarting: investigate disk space, directory permissions, port occupation and external-disk state per the watchdog chapter — don't bury the problem with manual restarts. Noticeably slower operations: check whether a migration or bulk upload is running, then check free disk space.

What to Provide When Reporting

When contacting support, provide everything at once: the time of the problem and the operation at that moment, the full lynxdrive-ctl status output, the relevant lines of lynxdrive-ctl logs around that time, plus browser and network details. The more complete the information, the fewer rounds of back-and-forth.