Saltar al contenido principal
Versión: v0.5.1-alpha

Instalación con un Solo Script

La forma más fácil de instalar phoenixd es usando nuestro script de instalación automatizado. Este script se encarga de la descarga, verificación y configuración de phoenixd en tu sistema Linux.

información

Leer Antes de Instalar

Por favor, lee esta página completa para entender qué hace el script de instalación, sus requisitos e implicaciones de seguridad antes de ejecutar cualquier comando. El script realizará cambios en el sistema y puede requerir permisos de sudo.

Instalación Rápida​

Ejecuta el siguiente comando en tu terminal:

Comando único (recomendado):

curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia-dev/master/scripts/install.sh | bash -s -- --yes

Métodos alternativos:

Si prefieres revisar el script antes de ejecutarlo, puedes descargarlo e inspeccionarlo manualmente primero:

Descarga el script y hazlo ejecutable:

wget https://raw.githubusercontent.com/olympus-btc/ambrosia-dev/master/scripts/install.sh
chmod +x install.sh

Ejecuta el script:

./install.sh

Qué Hace el Script​

El script de instalación realiza las siguientes operaciones:

  1. Descarga phoenixd v0.7.2 de los lanzamientos oficiales de ACINQ en GitHub.
  2. Verifica la integridad del paquete usando firmas GPG y checksums.
  3. Instala en un directorio en tu PATH (por defecto: /usr/local/bin).
  4. Configura tu entorno de shell para reconocer el comando phoenixd.
  5. Opcionalmente, configura un servicio de systemd para el inicio automático.

Proceso de Instalación​

Cuando ejecutes el script, verás:

⚡️ Bienvenido al instalador de Mastering phoenixd
-----------------------------------------
Instalando phoenixd 0.7.2 desde github.com/ACINQ/phoenixd/releases/download/v0.7.2

Verificación del Paquete​

El script incluye verificación automática:

🔐 Iniciando la verificación del paquete...
✅ Verificación del paquete exitosa.
✅ Verificación exitosa. El paquete es auténtico e intacto.

Esto asegura que estás instalando una versión auténtica y no modificada de phoenixd.

Configuración del Servicio Systemd​

Después de la instalación, se te preguntará:

¿Quieres configurar un servicio de systemd (requiere permiso de sudo)? (y/n):

Si eliges sí:

  • Crea un archivo de servicio de systemd en /etc/systemd/system/phoenixd.service.
  • Habilita e inicia el servicio.
  • Configura phoenixd para que se ejecute en mainnet por defecto.
  • Configura el reinicio automático en caso de fallo.

Luego puedes gestionar phoenixd usando comandos de systemd:

sudo systemctl start phoenixd
sudo systemctl stop phoenixd
sudo systemctl restart phoenixd
sudo systemctl status phoenixd
journalctl -u phoenixd -f  # Ver registros

Si eliges no:

  • Puedes ejecutar phoenixd manualmente con el comando phoenixd.
  • Usa phoenix-cli para interactuar con el demonio.

Post-Instalación​

Después de una instalación exitosa:

Operación Manual​

# Iniciar phoenixd manualmente
phoenixd --agree-to-terms-of-service

# En otra terminal, interactuar con phoenixd
phoenix-cli getinfo

Servicio Systemd (si está habilitado)​

# Controlar el servicio
sudo systemctl start phoenixd
sudo systemctl stop phoenixd
sudo systemctl restart phoenixd

# Comprobar el estado del servicio
sudo systemctl status phoenixd

# Ver registros
journalctl -u phoenixd -f

Requisitos​

  • Sistema Operativo: Linux (x64)
  • Dependencias: curl, unzip, sha256sum
  • Red: Conexión a internet para las descargas.
  • Permisos: Acceso de escritura al directorio de instalación, sudo para el servicio de systemd.

Solución de Problemas​

Comando no encontrado después de la instalación​

Si el comando phoenixd no es reconocido después de la instalación:

# Recarga la configuración de tu shell
source ~/.bashrc  # o ~/.zshrc

# O reinicia tu terminal

Fallos de verificación​

Si la verificación del paquete falla:

  • Comprueba tu conexión a internet.
  • Asegúrate de que GPG esté instalado correctamente.
  • Visita la página oficial de lanzamientos para una verificación manual.

Problemas de permisos​

Si encuentras errores de permisos:

  • Asegúrate de tener acceso de escritura al directorio de instalación.
  • Usa sudo para instalaciones a nivel de sistema.
  • Considera usar el directorio ~/.local/bin.

Notas de Seguridad​

El script de instalación:

  • ✅ Descarga solo de fuentes oficiales de ACINQ.
  • ✅ Verifica los paquetes usando firmas GPG.
  • ✅ Valida los checksums antes de la instalación.
  • ✅ Usa conexiones HTTPS seguras.
  • ✅ Proporciona total transparencia de las operaciones.

Siempre revisa los scripts antes de ejecutarlos con privilegios elevados.

Próximos Pasos​

Después de la instalación, consulta: