Instalación
Requisitos Mínimos
- SO: Linux, macOS o Windows 10/11 (64 bits), siempre que pueda ejecutar Docker. En macOS y Windows, revisa las versiones que soporta Docker Desktop: macOS, Windows
- RAM: 4GB mínimo, 8GB recomendado
- Espacio en Disco: 2GB de espacio libre
- Red: Conexión a internet
Paso 1: Instala dependencias (Docker, git y curl)
Para Linux (Ubuntu/Debian)
Abre tu terminal y ejecuta los siguientes comandos:
# Actualizar lista de paquetes
sudo apt update
# Instalar Docker y Git
sudo apt install -y curl docker.io git
# Instalar Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
# Agregar tu usuario al grupo docker (permite ejecutar Docker sin sudo)
sudo usermod -aG docker $USER
# Refrescar tu sesión de usuario para aplicar los cambios de grupo
su - $USER
Para macOS
- Descarga Docker Desktop para Mac desde docker.com
- Abre el archivo
.dmgdescargado - Arrastra Docker a tu carpeta de Aplicaciones
- Abre Docker desde Aplicaciones
- Sigue el asistente de configuración
- Docker se iniciará automáticamente
Para Windows
- Descarga Docker Desktop para Windows desde docker.com
- Ejecuta el instalador
- Sigue el asistente de instalación
- Reinicia tu computadora cuando se te solicite
- Abre Docker Desktop desde el menú de Inicio
- Espera a que Docker inicie (verás un ícono verde en la bandeja del sistema)
Verificar la Instalación de Docker
Después de instalar Docker, verifica que funciona correctamente:
docker --version
Deberías ver una salida como:
Docker version 28.2.2, build 28.2.2-0ubuntu1
Verificar que Git está Instalado
git --version
Si ves el número de versión, ¡Docker y Git están instalados correctamente! Pasa al Paso 3.
Paso 2: Instala Git (Si aún no está instalado)
Git es necesario para descargar el código fuente de Ambrosia desde GitHub.
Instalar Git
Para macOS:
brew install git
(Requiere Homebrew. Si no tienes Homebrew, descarga Git desde git-scm.com)
Para Windows: Descarga e instala desde git-scm.com
Paso 3: Clona el Repositorio de Ambrosia
Ahora descargaremos el código fuente de Ambrosia desde GitHub.
Si ya tienes la carpeta ambrosia de una instalación anterior, sáltate este paso y sigue "Actualiza desde una Versión Anterior" en el Paso 4.
Navega a tu Directorio Preferido
# Instala en tu directorio home
cd ~
Clona el Repositorio
Ejecuta los siguientes comandos para descargar Ambrosia:
# Clonar el repositorio desde GitHub
git clone https://github.com/olympus-btc/ambrosia.git
# Navegar al directorio del proyecto
cd ambrosia
La rama main siempre corresponde al último release de Ambrosia (v0.9.0-beta cuando se escribió esta guía).
Verifica los Archivos
Comprueba que estás en el directorio correcto con los archivos del proyecto:
ls
Deberías ver archivos que incluyen:
docker-compose.yml(configuración de Docker)README.md(documentación del proyecto)- Varias carpetas como
server,client, etc.
Paso 4: Construye e Inicia los Contenedores
Ejecuta estos comandos desde el directorio ambrosia.
Actualiza desde una Versión Anterior
Sáltate esto si es una instalación nueva. Si ya usaste una versión anterior de Ambrosia con Docker, primero trae el código más reciente y reconstruye las imágenes:
git pull
docker-compose up --build -d
Inicia Ambrosia
docker-compose up -d --wait && docker-compose restart
Este proceso puede tardar 3-5 minutos en la primera ejecución, especialmente con conexiones a internet lentas. Los inicios posteriores serán mucho más rápidos.
Paso 5: Respalda tus palabras semilla
Anota tu semilla y guárdala en un lugar seguro/secreto (MUY IMPORTANTE ANTES DE PONER DINERO EN EL NODO):
docker exec -it phoenixd cat /phoenix/.phoenix/seed.dat
También puedes verla después en la app, en Configuración → Bitcoin y Wallet → SEED de Lightning.
Paso 6: Configura phoenixd para liquidez entrante
Por defecto, phoenixd solicitará 2Msat de liquidez entrante al LSP de ACINQ, cada vez que se quede sin liquidez entrante. Esto incluye cuando inicias el nodo por primera vez y recibes tu primer pago. ACINQ cobra el 1% del monto de liquidez entrante solicitada, que son 20ksat (más la comisión de minería). Como 20ksat equivalen aproximadamente a US$20 al momento de escribir esto, y como no necesitamos tanta liquidez entrante para un workshop, configuramos phoenixd para que no solicite liquidez entrante.
(Nota: si realmente quieres 2M sats de liquidez entrante, omite esto. Si tomas esta ruta, deberías enviar ~25ksats como tu primer pago, la mayoría de los cuales serán tomados por ACINQ como comisión):
Ejecuta el siguiente comando:
docker exec phoenixd sh -c "\
sed -i '/^auto-liquidity=/d' /phoenix/.phoenix/phoenix.conf && \
echo 'auto-liquidity=off' >> /phoenix/.phoenix/phoenix.conf && \
sed -i '/^max-mining-fee=/d' /phoenix/.phoenix/phoenix.conf && \
echo 'max-mining-fee=5000' >> /phoenix/.phoenix/phoenix.conf \
" && docker restart phoenixd
Paso 7: Verifica la configuración de auto-liquidity en phoenix.conf
docker exec phoenixd cat /phoenix/.phoenix/phoenix.conf
Deberías ver las siguientes dos líneas al final:
auto-liquidity=off
max-mining-fee=5000
Si no ves estos valores, significa que auto-liquidity todavía está ACTIVADO. En ese caso, Phoenixd requerirá que abras un canal con 25,000 sats, lo que te dará aproximadamente 2M sats de liquidez entrante. Si quieres menos liquidez (y por lo tanto pagar menos para abrir el canal), regresa al Paso 6: Configura phoenixd para liquidez entrante y ajusta tu configuración.
Estos sats cubren la comisión de minería para abrir un canal con ACINQ. No son reembolsables.
Paso 8: Accede a Ambrosia
- Abre tu navegador web (Chrome, Firefox, Safari, Edge, etc.)
- Navega a: http://localhost:3000
- Deberías ver la pantalla de onboarding de Ambrosia
Es posible que debas desactivar tu VPN si la página no carga
Para actualizar Ambrosia más adelante, consulta Actualizar Ambrosia. Para abrirlo desde una tablet o un teléfono, consulta Otros Dispositivos.