Quickstart is broken

[kandsten]

You have several issues with the quickstart:

• The docker-compose stack is trying to pull from ghcr.io/api7/aisix:latest which throws access errors. api7/aisix:latest, implicit dockerhub, works. No idea if that's the intended image.
• :3001/ui UI throws crypto.randomUUID is not a function. (In 'crypto.randomUUID()', 'crypto.randomUUID' is undefined)
• :3001/aisix/admin throws a 404

Same issues with both :latest and :dev images.

With the risk of sounding snarky, did anyone test this even once before publishing?

[coderabbitai]

🔗 Related PRs

api7/aisix#105 - feat: add Docker quickstart for one-command local setup [merged]
api7/aisix#131 - docs: rewrite quick-start to Docker one-liner, update admin-ui [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[bzp2010]

Hi, @kandsten

As of when we created the 0.1.0 tag, it was still working fine.

Since then, we’ve added a dozen new features, the main branch is used for development. We run unit tests and E2E tests on every commit to ensure there are no functional breaks. We’re also adding additional test cases to achieve greater coverage.

However, the toolchain used for releasing is not currently covered by our guarantees; those components are only used during the release process. If something breaks, we’ll fix it before the release.

Anyway, since you’ve brought up this issue, I’ll take a look at it later.

---

1. Regarding ghcr.io/api7/aisix:latest, this was indeed an oversight. We removed it some time ago and published these images on Docker Hub. I’ll fix it shortly.

   Now you can start it this way.

   curl -fsSL https://run.api7.ai/aisix/quickstart | AISIX_IMAGE=api7/aisix:0.1.0 sh

2. I was unable to reproduce the crypto.randomUUID error in my setup described above.

   Your message mentions :3001/ui, so I assume you are not accessing the dashboard via 127.0.0.1 or localhost.
   Browsers enforce strict security restrictions on the Web Crypto API; if you are not using HTTPS or opening a page on a localhost address, these APIs will be disabled.

   Therefore, you need to enable TLS or use a local address.

3. According to the code, AISIX only processes requests when the URI and method match exactly; in all other cases, it returns a 404. Therefore, the third issue is expected behavior.

   Simply sending a request to :3001/aisix/admin will not do anything.