​
CLI install issues

  • Ensure your OS and architecture are supported by the installer output.
  • If portway isn’t found, add the printed install directory to your PATH and re-open your shell.

​
Local build fails during deploy

  • Confirm Docker is running locally.
  • Try building the same service with docker compose build to surface Dockerfile errors.

​
Registry authentication problems

  • Verify credentials and image names in your Compose file when using an external registry.
  • If using local builds, let portway deploy finish so it can push to Portway’s private registry automatically.