KeePass - Overriding the URL field
Learn how to override the KeePass URL field to launch programs like PuTTY, WinSCP, or a Remote Desktop connection (RDP) directly from your entries.
This article is over a year old but was reviewed on July 30, 2026 — the content is still accurate.
This article is part of the WinSCP & remote file transfer series:
- KeePass - Overriding the URL field
- WinSCP - Retrieve a stored password
- Fatal error was starting Putty after having saved settings
- WinSCP - Synchronize host and remote
- FTP - Remove files and folders at light speed
- WinSCP - Visual Basic for Application use
- WinSCP - Download files with specific extension recursively
- Search your FTP server at lightning speed

This article shows how to repurpose the KeePass URL field to launch external programs instead of a web browser, using the cmd:// prefix and entry placeholders: starting PuTTY with saved credentials, opening WinSCP directly to an SFTP path, or launching a Windows Remote Desktop (mstsc.exe) connection to a saved host.
The url field can also be used to start a program and, thus, not only to contain a valid URL.
The official documentation is located here: https://keepass.info/help/base/autourl.html.
Start PuTTY from KeePass
If you don't have PuTTY installed on your machine, download it from https://www.putty.org/. You just need the putty.exe file. If PuTTY refuses your saved session with an authentication error, see Fatal error was starting Putty after having saved settings.
Download it and save putty.exe in a directory present in your PATH.
To do this, even if you're not an administrator of your machine, just start a MS-DOS console and run echo %PATH%. You'll then see the list of directories already present and choose the one where you can copy a new file. Then copy putty.exe in that folder. So, from now on, you can just run putty.exe from anywhere.
Update your KeePass entry and set the URL property to the following instruction: cmd://putty.exe -load "Default Settings" {S:host} -l {USERNAME} -pw {PASSWORD}
Caution
Make sure you have filled in the host advanced property.
Start WinSCP from KeePass
If you wish to open WinSCP (see also WinSCP - Synchronize host and remote) and see files, you can achieve this by updating your KeePass entry and setting the URL property to the following instruction: cmd://"{ENV_PROGRAMFILES_X86}\WinSCP\WinSCP.exe" sftp://{USERNAME}:{PASSWORD}@{S:ip}:{T-REPLACE-RX:/{S:port}/-1//}{S:path}
Caution
Make sure you have filled in the ip advanced property. You can also set the port and path properties; they are optional, however.
Start an RDP/TS connection from KeePass
You can also start a remote desktop / terminal server connection from within KeePass.
The URL has to be set like this: cmd://mstsc.exe /v:{S:host} /f
Caution
Make sure you have filled in the host advanced property.
This article is part of the WinSCP & remote file transfer series:
- KeePass - Overriding the URL field
- WinSCP - Retrieve a stored password
- Fatal error was starting Putty after having saved settings
- WinSCP - Synchronize host and remote
- FTP - Remove files and folders at light speed
- WinSCP - Visual Basic for Application use
- WinSCP - Download files with specific extension recursively
- Search your FTP server at lightning speed


