Skip to main content

Troubleshoot deployment

Dockerfile requirements​

# Must target linux/amd64
FROM --platform=linux/amd64 node:18

# Must run as root (TEE requirement)
USER root

# Application code
WORKDIR /app
COPY . .
RUN npm install

CMD ["npm", "start"]

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):

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

App fails to start​

Check logs:

ecloud compute app logs <app-id>

Common issues:

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