Instalación
1. Verificación de Requisitos Previos
Antes de continuar, asegúrate de tener las siguientes dependencias instaladas. Puedes verificarlas con estos comandos:
- Node.js (v22+):
node -v - npm (v10+):
npm -v - JDK/JRE (v21):
java -version
El script de instalación también necesita curl, unzip, tar, sha256sum y gpg. Los verifica por su cuenta y se detiene si falta alguno.
Si te falta alguna de estas, consulta la Guía Detallada de Dependencias.
2. Instalación
El script de instalación requiere privilegios sudo para instalar binarios en /usr/local/bin y configurar servicios systemd.
Comando único (recomendado):
Instalación automática (incluye servicios systemd):
curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia/refs/tags/v0.9.0-beta/scripts/install.sh | bash -s -- --yes
Instalación automática (sin servicios systemd):
curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia/refs/tags/v0.9.0-beta/scripts/install.sh | bash -s -- --yes --no-service
Agrega --expose-lan al comando de instalación si el servidor de Ambrosia debe escuchar en tu red local y no solo en esta computadora. Solo tiene efecto en una instalación nueva: escribe http-bind-ip=0.0.0.0 en un ~/.Ambrosia-POS/ambrosia.conf nuevo. Úsalo solo en una red de confianza. No lo necesitas para abrir Ambrosia desde una tablet o un teléfono; consulta Otros Dispositivos.
Métodos alternativos:
Si prefieres revisar el script antes de ejecutarlo, o si quieres una instalación interactiva que te pregunte si instalar servicios systemd para cada componente, puedes descargarlo e inspeccionarlo primero.
Descarga el script y hazlo ejecutable:
wget -q https://raw.githubusercontent.com/olympus-btc/ambrosia/refs/tags/v0.9.0-beta/scripts/install.sh
chmod +x install.sh
Ejecuta el script:
./install.sh
Este script de instalación unificado automatiza el despliegue del ecosistema completo de Ambrosia, incluyendo el nodo Lightning Phoenixd, el servidor backend y el cliente frontend. Maneja la verificación de dependencias, descargas seguras de binarios con validación GPG, configuración del entorno (actualizaciones de PATH), y la creación opcional de servicios systemd para cada componente, asegurando una operación en segundo plano sin interrupciones.
Si no usas los servicios systemd, deberás iniciar manualmente phoenixd, el backend y el frontend ejecutando los siguientes comandos en tu terminal como procesos separados:
run-phoenixd.sh
ambrosia
y
ambrosia-client
Una vez que ambos servicios estén en ejecución (ya sea vía systemd o manualmente), puedes acceder al Dashboard de Ambrosia en:
El script de instalación de Phoenixd lo instala automáticamente. El script descarga Phoenixd v0.9.0, verifica la integridad del paquete usando GPG y checksums, lo instala en /usr/local/bin, y opcionalmente configura un servicio systemd para inicio automático.
Consulta Mastering Phoenixd para más detalles.
Actualización
Para actualizar Ambrosia más adelante, consulta Actualizar Ambrosia.
Desinstalación
Para desinstalar Ambrosia POS y Phoenixd, ejecuta el siguiente script:
curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia/refs/tags/v0.9.0-beta/scripts/uninstall.sh | bash