Initial Setup

Estimated reading: 4 minutes 88 views

Overview

This section explains the initial setup process for OneDB Security Appliance after the OVA file has been deployed. The setup includes accessing the OneDB console, generating the SSL key, verifying service status, accessing the OneDB Web UI, and changing the initial password.

OneDB includes a setup menu that allows administrators to generate an SSL key to secure communication between the client browser and the OneDB server.

Load the OVA File

Deploy or load the OneDB OVA file into the virtualization environment.

After the OVA has been started, open the console of the virtual machine.

The console will display the IP address assigned to the OneDB server.

Example:

OneDB Application Server 
Running On IP : 192.168.114.128
Mon Feb 2 2026 15:29:49
---------------------------------------------
onedb-app login:

Use this IP address to access the OneDB console and Web UI.

Login to OneDB Security Appliance

Use the console credentials provided during deployment or by your OneDB administrator.

Field	Value
Username	Provided during deployment
Password	Provided during deployment

After a successful login, the OneDB console main menu will be displayed.

Initial Web Application Status

During the first installation, you can verify the OneDB service status from the console menu.

From the Main Menu, select:

1) Services

Then select:

2) List Services

This menu displays the services running under the OneDB system, including the Web Application service.

In a fresh installation, the Web Application status may appear as:

Service Status

+-------------------+-------------+
| Service           | Status      |
+-------------------+-------------+
| SSH               | RUNNING     |    
| Database Service  | RUNNING     |
| Web Application   | NOT RUNNING |
| Api Interface     | RUNNING     |
+-------------------+-------------+

As shown above, the status is displayed as NOT RUNNING. This usually indicates that the SSL key has not been generated yet.

To securely access the OneDB Web UI, generate the SSL key from the Setup menu first.

Generate SSL Key

To generate the SSL key, follow the steps below.

Step 1 – Open Setup Menu

From the Main Menu, select:

3) Setup

Step 2 – Select Generate SSL Key

From the Setup menu, select:

2) Generate SSL Key

Step 3 – Enter SSL Certificate Information

You will be prompted to enter the SSL certificate information.

Fill in the required information:

Field	Description
Common Name	The hostname or IP address used to access OneDB.
Organizational Unit	The department or business unit name.
Organization	The organization or company name.
City / Locality	The city name.
State / Province	The state or province name.
Country	The country code or country name.

After all required information has been entered correctly, the system will generate the SSL key.

If the process is successful, the following message will appear:

✅ Key generated successfully

Verify OneDB Services

After the SSL key has been generated, return to the Main Menu.

Select:

1) Services

Then select:

2) List Services

Use this menu to verify whether the OneDB services are running properly.

Service Status

+-------------------+-------------+
| Service           | Status      |
+-------------------+-------------+
| SSH               | RUNNING     |    
| Database          | RUNNING     |
| Web Application   | RUNNING     |
| Api Interface     | RUNNING     |
+-------------------+-------------+

As shown above, the Web Application service status is displayed as RUNNING. This indicates that the SSL key has been generated successfully and the Web Application service is active.

Access OneDB Web UI

After the services are running, open a browser and access the OneDB Web UI using HTTPS.

https://<onedb-hostname>:8443

Example:

https://192.168.114.128:8443

The OneDB Web UI uses HTTPS on port 8443.

Login to OneDB Web UI

Field	Value
Username	admin
Password	password

The initial administrator default password will be changed after the first login.

Change Initial Password

After logging in to the OneDB Web UI for the first time, change the initial password immediately.

This step is required to prevent unauthorized access using temporary or default credentials.

Recommended password practices:

Recommendation	Description
Use a strong password	Use a combination of uppercase letters, lowercase letters, numbers, and special characters.
Avoid default passwords	Do not continue using the initial password after setup.
Store securely	Store the password according to the organization’s password management policy.
Limit access	Only authorized administrators should have access to the OneDB administrator account.

Initial Setup Flow

Notes

During the first installation, the Web Application may remain in NOT RUNNING status until the SSL key is generated.

After the SSL key has been generated and the services are running, the OneDB Web UI can be accessed using:

https://<onedb-hostname>:8443

For security reasons, initial or default credentials should be changed immediately after the first login.

Everything You Need to Know