cli
Portabase CLI es la interfaz de línea de comandos oficial para gestionar y desplegar instancias de Portabase.
Ficha actualizada 25 sept 2026, 11:54 · upstream 25 sept 2026, 11:53 · release 26.9.3
Qué es cli
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Portabase CLI es la herramienta oficial para administrar instancias de Portabase desde la terminal. Permite crear agentes, gestionar bases de datos asociadas a ellos y desplegar paneles de control (dashboards). La instalación se realiza mediante un script de bash que descarga el instalador oficial.
El software gestiona automáticamente archivos de configuración como docker-compose.yml, regenerándolos basándose en variables de entorno (.env) y definiciones de bases de datos (databases.json). Esto simplifica la gestión del ciclo de vida de las aplicaciones sin necesidad de editar manualmente los archivos de Docker Compose principales.
Soporta una amplia gama de sistemas de almacenamiento de datos incluyendo PostgreSQL, MySQL/MariaDB, MongoDB y Redis. La herramienta está escrita en Python utilizando frameworks como Typer y Rich, lo que garantiza una experiencia de usuario interactiva y robusta en la consola.
- Gestión centralizada de copias de seguridad y restauración para múltiples bases de datos heterogéneas.
- Despliegue rápido de instancias de Portabase con configuración automática de contenedores Docker.
- Administración de agentes individuales para aislar entornos de desarrollo o producción.
- Creación y gestión de dashboards personalizados sin tocar archivos YAML manualmente.
- Soporte nativo para múltiples motores de bases de datos (PostgreSQL, MySQL, MongoDB, Redis).
- Gestión automática de docker-compose.yml basada en .env y databases.json.
- Licencia Apache 2.0 que permite uso libre y modificación del código fuente.
- Interfaz CLI interactiva desarrollada con Python, Typer y Rich para mejor UX.
- Compatibilidad multiplataforma: Linux, macOS y Windows.
- Complejidad técnica elevada (HIGH) que puede requerir conocimientos de administración de sistemas.
- Instalación inicial mediante script curl en lugar de un gestor de paquetes estándar como pip o npm.
- No incluye Dockerfile propio, dependiendo de scripts externos para la construcción del entorno.
- Las bases de datos se gestionan a nivel de agente, requiriendo estructura específica de carpetas.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para actualizaciones desde versiones anteriores (26.08 o inferiores), revise el archivo docker-compose.legacy.yml generado. Utilice siempre portabase build <name> --diff para previsualizar cambios antes de aplicarlos. Mantenga personalizaciones en docker-compose.override.yml, ya que la CLI no lo modifica y Docker Compose lo fusiona automáticamente.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.