Differences
This shows you the differences between the selected revisions of the page.
| config 2020-11-03 | config 2024-12-21 20:19 (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). &beta_feature | ||
| 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 ===== | ||
| + | //See [[guide_config_cloud|*]]//. | ||
| ===== [[registry_key]] Registry Key ===== | ===== [[registry_key]] Registry Key ===== | ||
| - | If you use registry as configuration storage, the configuration is stored under following key. | + | If you use registry as configuration storage, the configuration is stored under the following key: |
| <code> | <code> | ||
| [HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2] | [HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2] | ||
| Line 34: | Line 39: | ||
| You may also use an INI file in a different folder or with a different name using ''[[commandline#configuration|/ini]]'' switch or in [[ui_pref_storage|preferences]]. | You may also use an INI file in a different folder or with a different name using ''[[commandline#configuration|/ini]]'' switch or in [[ui_pref_storage|preferences]]. | ||
| + | |||
| + | ===== [[no]] No Configuration ===== | ||
| + | |||
| + | With [[commandline#configuration|''/ini=nul'' command-line switch]], WinSCP starts with the default configuration and does not save the configuration on exit. That is particularly useful for [[scripting]], to make sure that the [[scripting#configuration|script always starts with all defaults]]. This is also the configuration mode used by [[library|WinSCP .NET assembly]]. | ||
| ===== [[readonly]] Read-Only Configuration ===== | ===== [[readonly]] Read-Only Configuration ===== | ||
| Line 41: | Line 50: | ||
| ==== [[readonly_sections]] Read-Only Configuration Sections ==== | ==== [[readonly_sections]] Read-Only Configuration Sections ==== | ||
| - | //In the recent versions,// &recent you can set individual configuration sections read-only. This way you can for example prevent a user from changing default transfer settings, while still allowing other kinds of customizations. | + | You can set individual configuration sections read-only. This way you can for example prevent a user from changing default transfer settings, while still allowing other kinds of customizations. |
| Setting a configuration section read-only makes WinSCP silently discard any changes to that section, when saving the configuration. | Setting a configuration section read-only makes WinSCP silently discard any changes to that section, when saving the configuration. | ||
| Line 69: | Line 78: | ||
| ==== [[ini_readonly]] Read-Only INI File ==== | ==== [[ini_readonly]] Read-Only INI File ==== | ||
| - | A simpler way to make whole configuration read-only is to use an INI file and set it read-only in a file system. This option is available even in the older versions. &recent | + | A simpler way to make whole configuration read-only is to use an INI file and set it read-only in a file system. |
| When INI file directory or the file itself is not writable (for example when the INI file is in ''Program Files'' folder or when it is explicitly set read-only), WinSCP does not preserve its state when exiting. No error message is displayed. Only when you explicitly change configuration (such as when you save [[session_configuration|site]], or submit [[ui_preferences|Preferences dialog]]), an error is shown. You can make WinSCP overwrite a read-only INI file by holding ''Shift'' key, while closing or submitting Preferences dialog. | When INI file directory or the file itself is not writable (for example when the INI file is in ''Program Files'' folder or when it is explicitly set read-only), WinSCP does not preserve its state when exiting. No error message is displayed. Only when you explicitly change configuration (such as when you save [[session_configuration|site]], or submit [[ui_preferences|Preferences dialog]]), an error is shown. You can make WinSCP overwrite a read-only INI file by holding ''Shift'' key, while closing or submitting Preferences dialog. | ||
| ===== [[auto]] Auto-selecting Storage ===== | ===== [[auto]] Auto-selecting Storage ===== | ||
| - | On startup, WinSCP first looks for an 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 its key in registry (The key is created by installer, so installed WinSCP uses registry by default). If it does not find that 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 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''. 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 ===== | ||