Troubleshooting
Getting help and reporting bugs
Where to ask about linscp, what to put in a bug report, and how to clean a log before sharing it.
linscp is supported on GitHub. Pick the right place for your request, include what the maintainers need to reproduce it, and remove private data first.
Where to go
Section titled “Where to go”| You have | Go to |
|---|---|
| A question, or you are not sure it is a bug | GitHub Discussions |
| Something that does not work as this manual says, or a crash | GitHub issues |
| A security problem | Private report, see reporting a vulnerability |
Help › Support Forum in linscp opens the issues page.
Before you report
Section titled “Before you report”- Work through first steps.
- Search existing issues and discussions, including closed ones.
- Check that the problem still happens with the newest release.
What to include
Section titled “What to include”- Version and package. From Help › About, and how you installed it:
.deb, AppImage, Flatpak, Windows installer or portable zip. - System. Distribution and version (for example Debian 13), desktop and session type (Wayland or X11), or the Windows version.
- Where it happens. The GUI or
linscp-cli; in the GUI, the Commander or Explorer interface. - Protocol and server. SFTP, SCP, FTP, FTPS, WebDAV or S3, and the server software if you know it. Commands › Server/Protocol Information shows what linscp learned about it.
- Exact error text. Copy it from the dialog rather than retyping it.
- Steps. What you did, what you expected, what happened instead. A report that others can reproduce gets fixed much sooner.
- A session log of one attempt, at level Normal or as requested (see recording a session log).
- For scripts: the script, the full command line, and the console output.
- For crashes: start linscp from a terminal and copy what it prints. On
Linux,
coredumpctl info linscpmay show a backtrace if your system collects crash dumps. - For display problems: a screenshot.
Clean up logs and screenshots
Section titled “Clean up logs and screenshots”A session log can reveal more than you want to share.
- Passwords. Logs contain no passwords unless Log passwords and other sensitive information was checked. If it was, turn it off and record a new log.
- Names. Replace host names, user names, IP addresses and private paths.
Replace each one consistently, for example every
files.internal.corpwithfiles.example.org, so the log still makes sense. - Do not delete lines. Shorten the log to the failing attempt, but keep every line of it. Missing lines often hide the cause.
- Keys and tokens. Never post a private key, an S3 secret, or a session token. Public host key fingerprints are fine.
- Screenshots. Blur host names and file names you do not want public.
If a log cannot be cleaned without losing the important part, say so in the issue; a maintainer may suggest another way to share it.
Feature requests
Section titled “Feature requests”Open a discussion first. Say what you want to achieve, not only which control is missing. If the feature exists in WinSCP, name it; linscp follows WinSCP closely and may already plan it.