# Add Connection

Connect an Oracle database to TuneVault. Agent is recommended — no firewall changes required.

1
Connection Type
2
Configure
3
Run Installer
Step 1 Choose Connection Type

How does TuneVault reach your Oracle database?

Recommended
🤖
Agent Installer
One command on your Oracle server. Outbound-only HTTPS — no firewall changes, no inbound ports.
🔌
Direct Connection
TuneVault connects to your Oracle listener directly. Requires network access from our servers.
Step 2 Server Details

Tell us about the Oracle server so the agent can connect back. The agent auto-detects Oracle SIDs after install.

Connection name Optional — auto-generated if blank.
Host IP or hostname IP or hostname of the Oracle server (reachable from TuneVault).
SSH username OS user for the agent (typically `oracle`).
Privilege Model
Recommended
Standard
✅ All 200+ health checks
✅ ADDM analysis
✅ SQL Tuning Advisor
✅ Wait event analysis
⚠️ Read-only — ops actions disabled
Advanced
✅ Everything above
✅ Kill session, ALTER SYSTEM
✅ RMAN, listener bounce
✅ ADOP phases (EBS)
Use the OS `oracle` user via SSH + sudo sqlplus. No password file required.
Hand this to your DBA. TuneVault never asks for SYSDBA unless you choose the Advanced model.
SQL — run as SYSTEM
Loading…
Full privilege model docs →
Generating…
Step 2 Oracle Connection Details

Enter the Oracle database credentials. TuneVault connects directly to your listener.

Connection name Optional — auto-generated from host/service if blank.
Host
Port
Service name
Oracle username
Oracle password
Privilege Model
Recommended
Standard
✅ All 200+ health checks
✅ ADDM analysis
✅ SQL Tuning Advisor
✅ Wait event analysis
⚠️ Read-only — ops actions disabled
Advanced
✅ Everything above
✅ Kill session, ALTER SYSTEM
✅ RMAN, listener bounce
✅ ADOP phases (EBS)
Use the OS `oracle` user via SSH + sudo sqlplus. No password file required.
Hand this to your DBA. TuneVault never asks for SYSDBA unless you choose the Advanced model.
SQL — run as SYSTEM
Loading…
Full privilege model docs →
Creating…
Step 3 Run This on Your Oracle Server

Paste the command below into a root terminal on your Oracle server. It handles everything: agent install, proxy setup, and systemd services.

One command does it all. No firewall changes needed. The agent connects outbound to TuneVault — zero inbound ports required. It registers itself automatically.
Terminal (root) — Oracle server
⟳ Generating secure install command…
Waiting for agent… Run the command above. The page updates automatically.
⟳ Agent connected
⟳ Proxy agent running
⟳ Registered with TuneVault
Select Oracle Database

The agent detected multiple Oracle SIDs on this server. Pick the one you want TuneVault to monitor.

Saving…
Verifying connection…
Go to Dashboard →

Start a health check from the dashboard to run all 200+ Oracle checks.