Instalación
OmniDB ofrece 2 tipos de paquetes para adaptarse a las necesidades de cada usuario:
- OmniDB Application: ejecuta un servidor web en un puerto aleatorio por debajo, y proporciona una ventana de navegador simplificada para usar la interfaz de OmniDB sin ninguna configuración adicional. Se siente igual que una aplicación de escritorio.
- OmniDB Server: ejecuta un servidor web en un puerto aleatorio, o en un puerto especificado por el usuario. El usuario debe conectarse a él a través de un navegador web. Ofrece gestión de usuarios, ideal para alojarse en un servidor dentro de la red de los usuarios.
Tanto la aplicación como el servidor pueden instalarse en la misma máquina.
OmniDB Application
Importante: el repositorio original https://github.com/OmniDB/OmniDB/releases contiene solo versiones antiguas (hasta ~2020) y ya no se mantiene — consulte Funciones heredadas e historial para saber qué cambió desde entonces.
Para las versiones actuales, use la página de versiones del proyecto. Desde la reescritura en Go, cada versión es un único archivo autocontenido por plataforma (además de un instalador opcional para Windows), sin runtime independiente que instalar previamente:
- macOS (Apple Silicon o Intel):
OmniDB-macOS-osx-arm64.zip/OmniDB-macOS-osx-x64.zip - Linux x64:
OmniDB-linux-x64.tar.gz - Windows x64:
OmniDB-win-x64.zip, o el instaladorOmniDB-win-x64-setup.exe
Descomprima (o extraiga) el archivo correspondiente a su plataforma y ejecute la aplicación/binario OmniDB dentro — eso es toda la instalación.
Instalación mediante Homebrew (solo macOS – recomendado)
Para los usuarios de macOS que prefieran usar un gestor de paquetes, OmniDB está disponible a través de un tap personalizado de Homebrew:
# Install the latest version:
brew install --cask heptau/tap/omnidb
# To upgrade later:
brew upgrade heptau/tap/omnidb
Homebrew descargará automáticamente el ZIP correcto para su arquitectura (Apple Silicon o Intel), lo descomprimirá y colocará OmniDB.app en su carpeta de Aplicaciones.
La definición del cask se mantiene aquí: heptau/homebrew-tap – omnidb.rb
Instalación mediante winget (solo Windows)
Para los usuarios de Windows que prefieran usar un gestor de paquetes, OmniDB está disponible a través del Windows Package Manager, incluido en Windows 10 y 11:
# Instalar la última versión:
winget install heptau.OmniDB
# Para actualizar más tarde:
winget upgrade heptau.OmniDB
El manifiesto se mantiene aquí: microsoft/winget-pkgs.
Descarga directa (todas las plataformas)
Estos enlaces siempre apuntan a la última versión. Para versiones anteriores, sumas de comprobación y notas de la versión, consulte la página de versiones.
Descomprima el archivo correspondiente a su plataforma y lance la aplicación de la forma habitual: en
macOS, arrastre OmniDB.app a Applications y ábrala desde
Launchpad/Spotlight o con open -a OmniDB; en Linux, ejecute
el binario OmniDB directamente; en Windows, ejecute OmniDB.exe (o el instalador).
Consulte Aplicación de escritorio para saber dónde guarda la aplicación sus datos, su barra de menús y sus atajos de teclado, así como particularidades de macOS como la importación de datos de una instalación anterior.
OmniDB Server
El mismo archivo de la versión también contiene omnidb-server — un
binario independiente, sin interfaz gráfica, junto a la aplicación de escritorio (la aplicación de escritorio en realidad
lanza este mismo binario internamente, como proceso hijo, forzando el modo aplicación).
Ejecútelo directamente para el modo servidor accesible por navegador, sin ningún shell
de escritorio de por medio:
user@machine:~$ ./omnidb-server
omnidb-server: listening on 127.0.0.1:52149 — open http://127.0.0.1:52149/omnidb_login/ in your browser
Por defecto, OmniDB escucha únicamente en 127.0.0.1 y elige un puerto libre
automáticamente. Puede especificar ambos explícitamente:
user@machine:~$ ./omnidb-server -p 8080 -H 0.0.0.0
omnidb-server: listening on 0.0.0.0:8080 — open http://0.0.0.0:8080/omnidb_login/ in your browser
Consulte Despliegue de omnidb-server para el conjunto completo de opciones
y las configuraciones de despliegue recomendadas (en particular, por qué se desaconseja exponer -H 0.0.0.0
directamente a internet sin un proxy inverso delante — no hay
soporte TLS integrado).
OmniDB con Oracle
Ni la aplicación ni el servidor de OmniDB requieren software adicional para conectarse a Oracle — a diferencia de versiones anteriores, no se necesita instalar un Oracle Instant Client independiente. La conectividad con Oracle está implementada de forma nativa (un driver puro en Go), por lo que funciona de fábrica igual que cualquier otra base de datos compatible. Lo mismo ocurre con MS SQL Server y Firebird: ambos también usan drivers puros en Go, por lo que tampoco se necesita ningún driver ODBC, biblioteca de cliente nativa ni ningún otro paso de instalación adicional para ninguno de los dos.
Base de datos de usuario de OmniDB
En la primera ejecución, tanto el servidor como la aplicación crean un archivo
~/.omnidb/omnidb-app/omnidb.db (para OmniDB app) o
~/.omnidb/omnidb-server/omnidb.db (para OmniDB server) en el directorio
home del usuario, si aún no existe — junto con una cuenta de superusuario admin.
La aplicación de escritorio inicia sesión con ella automáticamente; en modo servidor, su
contraseña se genera aleatoriamente y se muestra una sola vez en la salida de registro del
servidor (la línea que contiene initial login: admin / …). Este archivo también se llama la
base de datos de usuario y contiene todos los usuarios, conexiones y demás
datos de la aplicación. Si ya existe (por ejemplo, tras una actualización), OmniDB lo usa tal cual — nunca
se sobrescribe ni se restablece automáticamente.
OmniDB en el navegador
Una vez que omnidb-server esté en ejecución, abra en su navegador favorito la dirección que
mostró al arrancar (por ejemplo http://127.0.0.1:52149/omnidb_login/). Verá la página de
inicio de sesión de OmniDB; inicie sesión como admin con la contraseña de un solo uso que figura
en el registro. En los próximos capítulos veremos cómo crear usuarios y conexiones y cómo
trabajar con OmniDB. La aplicación de escritorio se salta este paso por completo: abre directamente el
espacio de trabajo.