Skip to content

Commit 60fb42f

Browse files
Doc 1607 self signed cert (#3621)
1 parent 054ae6d commit 60fb42f

File tree

1 file changed

+33
-3
lines changed

1 file changed

+33
-3
lines changed

docs/hosting/configuration/configuration-examples/custom-certificate-authority.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ contentType: howto
99

1010
You can add your own certificate authority (CA) or self-signed certificate to n8n. This means you are able to trust a certain SSL certificate instead of trusting all invalid certificates, which is a potential security risk.
1111

12-
/// note | Available in version 1.42.0
13-
This feature is only available in version 1.42.0+.
12+
/// note | Added in version 1.42.0
13+
This feature is available in version 1.42.0 and above.
1414
///
1515

16-
To use this feature you need to place your certificates in a folder and mount the folder to `/opt/custom-certificates` in the container.
16+
To use this feature you need to place your certificates in a folder and mount the folder to `/opt/custom-certificates` in the container. The external path that you map to `/opt/custom-certificates` must be writable by the container.
1717

1818
## Docker
1919

@@ -49,3 +49,33 @@ You should also give the right permissions to the imported certs. You can do thi
4949
```bash
5050
docker exec --user 0 n8n chown -R 1000:1000 /opt/custom-certificates
5151
```
52+
53+
## Certificate requirements for Custom Trust Store
54+
55+
Supported certificate types:
56+
57+
- Root CA Certificates: these are certificates from Certificate Authorities that sign other certificates. Trust these to accept all certificates signed by that CA.
58+
- Self-Signed Certificates: certificates that servers create and sign themselves. Trust these to accept connections to that specific server only.
59+
60+
You must use PEM format:
61+
62+
- Text-based format with BEGIN/END markers
63+
- Supported file extensions: `.pem`, `.crt`, `.cer`
64+
- Contains the public certificate (no private key needed)
65+
66+
For example:
67+
68+
```
69+
-----BEGIN CERTIFICATE-----
70+
MIIDXTCCAkWgAwIBAgIJAKoK/heBjcOuMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
71+
[base64 encoded data]
72+
-----END CERTIFICATE-----
73+
```
74+
75+
The system doesn't accept:
76+
77+
- DER/binary format files
78+
- PKCS#7 (.p7b) files
79+
- PKCS#12 (.pfx, .p12) files
80+
- Private key files
81+
- Convert these formats to PEM before use.

0 commit comments

Comments
 (0)