Deploy DBX with 1Panel

The 1Panel app store provides the official DBX Docker image, so you can install and update the DBX web edition without writing Docker commands manually.

Optional server choice

If you still need a server for DBX, you can take a look at RainYun. RainYun is a cloud service provider offering cloud servers, physical servers, game hosting, and developer-friendly infrastructure services. Any server that meets the Docker and 1Panel requirements can host DBX as well.

Install DBX

1. Sign in to 1Panel and open App Store.

2. Search for DBX and select the official DBX app.

3. Select the version to install and click Install.

4. Review the installation fields:

   Setting	Default	Description
   Port	4224	The host port used to access DBX Web. Change it if the port is already in use.
   Access Password	Automatically generated	The password used to sign in to DBX Web. 1Panel generates the default value according to random: true, and you can change it during installation.

5. Click Confirm and wait for 1Panel to pull the image and start the container.

Open DBX

After installation, open the following address in a browser:

http://SERVER_IP:PORT

For example, when using the default port:

http://192.168.1.100:4224

Enter the Access Password from the installation form. If the page does not open, check that:

• the DBX app is running in 1Panel;
• the browser port matches the port in the installation form;
• the cloud security group and host firewall allow that port;
• the port is not already used by another service.

Persistence and updates

DBX application data is stored in the 1Panel app directory's data directory and mounted at /app/data inside the container. It contains DBX's storage database, saved connections, plugins, drivers, and other persistent runtime state. Restarting or updating the container preserves that data as long as the mounted directory is not removed.

To update DBX, open it under Installed apps in 1Panel, select an available version, and start the update. Confirm that the data directory is included in your server backup before updating.

DuckDB is not embedded in the dbx-web image. Install it separately from Driver Manager after the first launch. The driver is stored under /app/data/agents, so it is preserved by the same data mount.

Web Paths and Files

In a 1Panel deployment, the DBX backend reads the server or container filesystem:

• An SSH private-key path must be readable inside the container, not merely available on the browser computer.
• JDBC JARs, plugins, Agents, and downloaded drivers live in the server-side data directory.
• Browser uploads are copied to a controlled server-side directory before a task reads them.
• Database-file connections and server paths must be evaluated from the container's point of view.

Do not enter a personal computer's absolute path simply because the UI is open in that computer's browser. See What Is DBX? for the full Desktop/Web boundary.

Connect to a database

After signing in, click New Connection and enter the target database type, address, port, username, and database password. The DBX container must be able to reach the target database:

• For a database on the same server, use an address and port reachable from that server.
• For a database on the same Docker network, use its container name and container port.
• For a private-network database, connect the 1Panel server to that network or configure an SSH tunnel as needed.

Production Deployment Guidance

• Use a long, unique access password instead of an example value.
• Configure HTTPS through a 1Panel reverse proxy and restrict security-group and host-firewall exposure.
• Pin a version when controlled upgrades matter; back up /app/data and read the Changelog before updating.
• Use a dedicated least-privilege database account and prefer read-only protection for production connections.
• Review driver and plugin sources; do not place untrusted JARs or executables in the data directory.

See Production Safety for the database, write, AI, and API boundaries.