Skip to main content

Troubleshoot Deployment

Build fails: platform mismatch​

Ensure your Dockerfile specifies the platform:

FROM --platform=linux/amd64 node:18

Push fails: authentication required​

Login to Docker registry:

docker login

Transaction fails: insufficient funds​

Get Sepolia ETH (for sepolia environment) or Mainnet ETH (for mainnet-alpha environment):

eigenx auth whoami  # Get your address
# Visit faucet and request funds

App fails to start​

Check logs:

eigenx app logs <app-id>

Common issues:

  • Missing environment variables
  • Port binding issues
  • Application crashes
  • Incorrect entrypoint/command