Skip to content

Update the Oracle Database and Oracle Client requirements for n8n #3838

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Nov 14, 2025
+6 −5
Merged

Update the Oracle Database and Oracle Client requirements for n8n #3838

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
760abb9
Clarify requirements for Oracle Client Libraries
sharadraju Nov 3, 2025
e71b614
Update Oracle Database requirements in documentation
sharadraju Nov 3, 2025
9ceefed
Merge branch 'n8n-io:main' into main
sharadraju Nov 4, 2025
ac1cd88
Rephrase Oracle Client Libraries requirement
sharadraju Nov 4, 2025
21f0837
Rephrase Oracle Client Libraries requirement
sharadraju Nov 4, 2025
7ac456b
Update OracleDB reference to Oracle in documentation
sharadraju Nov 4, 2025
8327525
Clarify Oracle server reference in documentation
sharadraju Nov 4, 2025
330909e
Update requirements for Oracle Client Libraries
sharadraju Nov 4, 2025
f0cd826
Clarify requirements for Oracle Client Libraries
sharadraju Nov 4, 2025
01caea7
Update Oracle DB documentation for client libraries
sharadraju Nov 4, 2025
7d83cdd
Update documentation for Oracle Database features
sharadraju Nov 5, 2025
25a5049
Update Oracle Client Libraries requirement details
sharadraju Nov 5, 2025
aab3c05
Update Oracle Client Libraries description for clarity
sharadraju Nov 5, 2025
876d4be
Fix typo in OracleDB connection string description
sharadraju Nov 5, 2025
9982097
Merge branch 'n8n-io:main' into main
sharadraju Nov 7, 2025
4165519
Merge branch 'n8n-io:main' into main
sharadraju Nov 11, 2025
6634927
Merge branch 'n8n-io:main' into main
sharadraju Nov 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
Refer to [Oracle Database credentials](/integrations/builtin/credentials/oracledb.md) for guidance on setting up authentication.

Requires Oracle Database **19c or later**.
For thick mode, use Oracle Client Libraries **19c or later**.
For advanced Oracle Database features like Transparent Application Continuity (TAC) and Sharding, also requires Oracle Client Libraries **19c or later**.

Check failure on line 18 in docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Sharding'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Sharding'?", "location": {"path": "docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md", "range": {"start": {"line": 18, "column": 89}}}, "severity": "ERROR"}
///

--8<-- "/_snippets/integrations/builtin/app-nodes/ai-tools.md"
Expand Down
9 changes: 5 additions & 4 deletions docs/integrations/builtin/credentials/oracledb.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,13 @@

/// note
These nodes do not support SSH tunnels.
They require Oracle Database 19c or later. For thick mode, use Oracle Client Libraries 19c or later.
They require Oracle Database **19c or later**.
For advanced Oracle Database features like Transparent Application Continuity (TAC) and Sharding, they also require Oracle Client Libraries **19c or later**.

Check failure on line 18 in docs/integrations/builtin/credentials/oracledb.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Sharding'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Sharding'?", "location": {"path": "docs/integrations/builtin/credentials/oracledb.md", "range": {"start": {"line": 18, "column": 89}}}, "severity": "ERROR"}
///

## Prerequisites

Create a user account on a [OracleDB](https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-F0246961-558F-480B-AC0F-14B50134621C) server database.
Create a user account on an [Oracle Database](https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-F0246961-558F-480B-AC0F-14B50134621C) server.

## Supported authentication methods

Expand All @@ -35,8 +36,8 @@

- A **User** name.
- A **Password** for that user.
- **Connection String**: The Oracle database instance to connect to. The string can be an Easy Connect string, or a TNS Alias from a tnsnames.ora file, or the Oracle database instance.
- **Use Optional Oracle Client Libraries**: If you want to use node-oracledb Thick mode for working with Oracle Database advanced features, turn this on. This option is not available in official n8n docker images. Additional settings to enable Thick mode are required. Refer to [Enabling Thick mode documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#enabling-node-oracledb-thick-mode) for more information.
- **Connection String**: The Oracle Database instance to connect to. The string can be an Easy Connect string, or a TNS Alias from a tnsnames.ora file, or the Oracle Database instance.
- **Use Optional Oracle Client Libraries**: If you want to work with Oracle Database advanced features, turn this on. This option internally uses node-oracledb Thick mode. Additional settings to enable node-oracledb Thick mode are required. Refer to [Enabling Thick mode documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#enabling-node-oracledb-thick-mode) for more information. This option is not available in the official n8n docker images.

Check failure on line 40 in docs/integrations/builtin/credentials/oracledb.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-microsoft.Contractions] Use 'isn't' instead of 'is not'.

Raw Output:
{"message": "[from-microsoft.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "docs/integrations/builtin/credentials/oracledb.md", "range": {"start": {"line": 40, "column": 434}}}, "severity": "ERROR"}

Check warning on line 40 in docs/integrations/builtin/credentials/oracledb.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.Passive] 'are required' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[from-write-good.Passive] 'are required' may be passive voice. Use active voice if you can.", "location": {"path": "docs/integrations/builtin/credentials/oracledb.md", "range": {"start": {"line": 40, "column": 228}}}, "severity": "WARNING"}

Check warning on line 40 in docs/integrations/builtin/credentials/oracledb.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.TooWordy] 'Additional' is too wordy.

Raw Output:
{"message": "[from-write-good.TooWordy] 'Additional' is too wordy.", "location": {"path": "docs/integrations/builtin/credentials/oracledb.md", "range": {"start": {"line": 40, "column": 173}}}, "severity": "WARNING"}
- **Use SSL**: If your Connection String is using SSL, turn this on and configure additional details for the SSL Authentication.
- **Wallet Password**: The password to decrypt the Privacy Enhanced Mail (PEM)-encoded private certificate, if it is encrypted.
- **Wallet Content**: The security credentials required to establish a mutual TLS (mTLS) connection to Oracle Database.
Expand Down
Loading