Differences
This shows you the differences between the selected revisions of the page.
| config 2023-02-02 | config 2025-06-30 (current) | ||
| Line 13: | Line 13: | ||
| ===== [[import]] Importing/Restoring Configuration ===== | ===== [[import]] Importing/Restoring Configuration ===== | ||
| - | To import/restore the configuration, go to //Tools > Import/Restore configuration// on [[ui_login|Login dialog]]. | + | To import/restore the complete configuration including all stored sites, go to //Tools > Import/Restore configuration// on [[ui_login|Login dialog]]. |
| + | |||
| + | To [[ui_import#ini|import only selected sites]], you can alternatively use //Tools > Import Sites// (and select //INI file// for import source). | ||
| See also //[[faq_transfer_config|How do I transfer my settings from a non-working computer?]]// | See also //[[faq_transfer_config|How do I transfer my settings from a non-working computer?]]// | ||
| Line 20: | Line 22: | ||
| To transfer your configuration to another computer/location, [[#export|export the configuration]] to an INI file and then [[#import|import]] the file on the another computer/location. | To transfer your configuration to another computer/location, [[#export|export the configuration]] to an INI file and then [[#import|import]] the file on the another computer/location. | ||
| - | If you want to transfer just one specific stored site, you can [[ui_generateurl|generate a session URL]] from the site on the source location, transfer the URL to the target location, [[ui_login#pasting|paste it to the Login dialog]] and [[ui_login#new_site|save it]]. Make sure you include //Advanced settings// to the URL. | + | If you want to transfer just one specific stored site, you can [[ui_generateurl|generate a session URL]] from the site on the source location (make sure you include //Advanced settings// to the URL). Transfer the URL to the target location, [[ui_login#pasting|paste it to the Login dialog]] and [[ui_login#new_site|save it]]. |
| ===== Sharing the Configuration between Machines ===== | ===== Sharing the Configuration between Machines ===== | ||
| Line 32: | Line 34: | ||
| ===== [[ini]] INI File Location ===== | ===== [[ini]] INI File Location ===== | ||
| - | When loading configuration, WinSCP first looks for an INI file in the directory, where WinSCP executable is stored in. The INI file needs to have an ''.ini'' extension and the same name as the executable (i.e. ''WinSCP.ini''). If INI file in not found there, WinSCP looks to application data directory of your user profile, i.e. to ''C:\Users\username\AppData\Roaming\WinSCP.ini''. &winpath | + | When loading configuration, WinSCP first looks for an INI file in the directory, where WinSCP executable is stored in.((When installed using the official installer, the installation directory depends on [[ui_installer#mode|install mode]].)) The INI file needs to have an ''.ini'' extension and the same name as the executable (i.e. ''WinSCP.ini''). If INI file in not found there, WinSCP looks to application data directory of your user profile, i.e. to ''C:\Users\username\AppData\Roaming\WinSCP.ini''. &winpath |
| When you opt to use INI file for the first time, WinSCP tries to write it to directory, where WinSCP executable is stored in. If the directory is not writable, INI file is stored to application data directory of your user profile. | When you opt to use INI file for the first time, WinSCP tries to write it to directory, where WinSCP executable is stored in. If the directory is not writable, INI file is stored to application data directory of your user profile. | ||
| Line 81: | Line 83: | ||
| ===== [[auto]] Auto-selecting Storage ===== | ===== [[auto]] Auto-selecting Storage ===== | ||
| - | On startup, WinSCP first looks for an [[config#ini|INI file]] in the directory, where WinSCP executable is stored in;((Unless different location was forced using [[commandline#configuration|''/ini'' switch]].)) and then in the user profile directory. If it does not find INI file in either location, it looks for presence of [[config#registry_key|its key in registry]], both in ''HKCU'' and ''HKLM''. The ''HKLM'' key is created by the [[installation|installer]], so installed WinSCP uses the registry by default. If it does not find the registry key either, it creates an empty INI file in the directory, where WinSCP executable is stored in. If that directory is not writable, it creates an empty INI file in the user profile directory. | + | On startup, WinSCP first looks for an [[config#ini|INI file]] in the directory, where WinSCP executable is stored in;((Unless different location was forced using [[commandline#configuration|''/ini'' switch]].)) and then in the user profile directory. If it does not find INI file in either location, it looks for presence of [[config#registry_key|its key in registry]], both in ''HKCU'' and ''HKLM''.((For ''HKLM'' on 64-bit systems, the 32-bit key under ''WOW6432Node'' is used.)) The ''HKLM'' key is created by the [[installation|installer]], so installed WinSCP uses the registry by default. If it does not find the registry key either, it creates an empty INI file in the directory, where WinSCP executable is stored in. If that directory is not writable, it creates an empty INI file in the user profile directory. |
| ===== Checking What Store Is in Use ===== | ===== Checking What Store Is in Use ===== | ||