xref: /curl/docs/cmdline-opts/ssl.md (revision fe9f68fa)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: ssl
5Help: Try enabling TLS
6Protocols: FTP IMAP POP3 SMTP LDAP
7Added: 7.20.0
8Category: tls
9Multi: boolean
10See-also:
11  - ssl-reqd
12  - insecure
13  - ciphers
14Example:
15  - --ssl pop3://example.com/
16---
17
18# `--ssl`
19
20Warning: this is considered an insecure option. Consider using --ssl-reqd
21instead to be sure curl upgrades to a secure connection.
22
23Try to use SSL/TLS for the connection. Reverts to a non-secure connection if
24the server does not support SSL/TLS. See also --ftp-ssl-control and --ssl-reqd
25for different levels of encryption required.
26
27This option is handled in LDAP (added in 7.81.0). It is fully supported by the
28OpenLDAP backend and ignored by the generic ldap backend.
29
30Please note that a server may close the connection if the negotiation does
31not succeed.
32
33This option was formerly known as --ftp-ssl (added in 7.11.0). That option
34name can still be used but might be removed in a future version.
35