Desktop Apps
Install DBConvert Streams on your workstation for local exploration, SQL workflows, and first-run setup. No account is required to start — the Data Explorer and SQL Console are available immediately.
Desktop app compatibility
Desktop apps are available for:
Prerequisites
- 2 CPU cores
- 2 GB RAM
- 1 GB free disk space
Download and install
Go to Desktop Downloads and pick your platform.
Windows
| Package | Use case |
|---|---|
Installer (.exe) | Recommended. Adds a Start Menu entry. |
Portable (.zip) | No installation needed. Extract and run. |
Run the installer or extract the ZIP, then launch DBConvert Streams.
macOS
Download the ZIP, extract it, and move the app to Applications.
If macOS Gatekeeper blocks the first launch, right-click the app and choose Open.
Linux
| Package | Use case |
|---|---|
.deb (amd64) | Debian, Ubuntu, and derivatives. |
.rpm (x86_64) | Fedora, RHEL, and derivatives. |
.pkg.tar.zst (x86_64) | Arch Linux and derivatives. |
.tar.gz | Portable. Extract and run. |
Install with your package manager or extract the tarball:
# Debian/Ubuntu
sudo dpkg -i dbconvert-streams_2.1.0_amd64.deb
# Fedora/RHEL
sudo dnf install ./dbconvert-streams-2.1.0.x86_64.rpm
# Arch Linux
sudo pacman -U dbconvert-streams-2.1.0-x86_64.pkg.tar.zst
# Portable
tar -xzf dbconvert-streams-2.1.0-linux-amd64.tar.gz
./dbconvert-streams
Verify the installation
- Launch the app. It opens with Data Explorer as the default view.
- Add a source connection using the sidebar.
- Open the connection in Data Explorer and confirm your schemas and tables are visible.
If the connection test passes and objects appear in the explorer, the app is working.
Data locations
Windows
| Data | Location |
|---|---|
| App data root | %APPDATA%\DBConvert Streams\ |
| Configuration database | %APPDATA%\DBConvert Streams\config\config.db |
| Secrets | %APPDATA%\DBConvert Streams\secrets\secrets.enc |
| Runtime data | %APPDATA%\DBConvert Streams\runtime\ |
| Logs | %APPDATA%\DBConvert Streams\logs\ |
To open: press Win + R, type the path, press Enter.
Linux
| Data | Location |
|---|---|
| App data root | ~/.local/share/dbconvert-streams/ |
| Configuration database | ~/.local/share/dbconvert-streams/config/config.db |
| Secrets | ~/.local/share/dbconvert-streams/secrets/secrets.enc |
| Runtime data | ~/.local/share/dbconvert-streams/runtime/ |
| Logs | ~/.local/share/dbconvert-streams/logs/ |
macOS
Desktop app data is stored under ~/Library/Application Support/DBConvert Streams/.
Troubleshooting
Windows: SmartScreen warning
The application is not signed with an EV certificate. When Windows SmartScreen appears, click More info, then Run anyway.
Windows: WebView2 Runtime missing
DBConvert Streams uses Microsoft WebView2 for the UI. It ships with Windows 10/11, but if you see an error, download the WebView2 Evergreen Bootstrapper and restart the app.
Windows: high-DPI display issues
If the interface appears blurry on high-DPI displays:
- Right-click the
.exe→ Properties → Compatibility tab - Click Change high DPI settings
- Check Override high DPI scaling behavior → select Application
Windows: firewall prompt
On first launch, allow access on Private networks. This is required for the app to communicate with databases.
Linux: missing dependencies
If you see errors about missing libraries:
# Debian/Ubuntu
sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37
# Fedora
sudo dnf install gtk3 webkit2gtk4.1
# Arch Linux
sudo pacman -S gtk3 webkit2gtk-4.1
Linux: application won't start
- Run from terminal to see error messages:
dbconvert-streams - Verify WebKitGTK is installed:
# Debian/Ubuntu dpkg -l | grep webkit2gtk # Fedora rpm -qa | grep webkit2gtk # Arch pacman -Q webkit2gtk-4.1 - On Wayland with display issues, try:
GDK_BACKEND=x11 dbconvert-streams
Linux: permission denied (portable)
chmod +x dbconvert-streams
chmod +x services/stream-api
chmod +x services/stream-reader
chmod +x services/stream-writer
Uninstallation
Windows (installer)
Open Settings → Apps → Installed apps, find DBConvert Streams, and click Uninstall.
Windows (portable)
Delete the application folder. If you also want to remove local data, delete %APPDATA%\DBConvert Streams\.
Linux
# Debian/Ubuntu
sudo apt remove dbconvert-streams
# Fedora
sudo dnf remove dbconvert-streams
# Arch
sudo pacman -R dbconvert-streams
# Portable: delete the extracted directory
Desktop vs Docker
Choose the distribution that matches your workflow:
- Desktop app: best for individual users who want an interactive workstation-based setup for database exploration, SQL workflows, stream configuration, and working with local or remote data sources.
- Docker deployment: best for self-hosted server environments, shared or team setups, automated deployments, or cases where you want services managed outside a desktop app.
Both distributions can be valid depending on how you plan to use DBConvert Streams.
Next steps
- Quick Start — end-to-end first stream walkthrough
- Dashboard Overview — navigate the app UI