Skip to content

Azure: document the emulated Azure Portal (LS_AZURE_PORTAL) - #911

Draft
DrisDary wants to merge 1 commit into
mainfrom
docs/azure-emulated-portal
Draft

Azure: document the emulated Azure Portal (LS_AZURE_PORTAL)#911
DrisDary wants to merge 1 commit into
mainfrom
docs/azure-emulated-portal

Conversation

@DrisDary

@DrisDary DrisDary commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Motivation

localstack-pro#8172 adds an emulated Azure Portal served from the emulator's
own edge port, gated by LS_AZURE_PORTAL=1 (off by default). It is a new
user-facing feature with nothing in the docs: no way to discover it, enable
it, or understand its boundaries.

Changes

New page azure/developer-tools/portal.mdx (lands in the Azure → Developer
Tools sidebar next to lstk), covering:

  • Enabling it — LS_AZURE_PORTAL=1http://localhost:4566/_localstack/portal/,
    with an lstk env-profile example and a plain docker run
  • What it can do — resource browsing, create wizards, blob and Key Vault
    browsing, invoking any implemented ARM operation, coverage-aware greying
  • Disclaimers — preview status; the sign-in screen is a mock; the portal acts
    as the emulator's operator principal; local-only with no connection to real
    Azure; same trust model as the emulator API (anyone reaching port 4566 can
    use it); state follows the emulator's persistence
  • Troubleshooting — 404 means the flag is unset; the portal health endpoint
    as the first diagnostic

Related

  • Feature PR: localstack/localstack-pro#8172 (do not merge this page before
    it — the flag doesn't exist in any published image yet)
  • Companion PR: localstack/localstack-azure-portal#6

@DrisDary DrisDary self-assigned this Sep 2, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 51b035d
Status: ✅  Deploy successful!
Preview URL: https://e1d79284.localstack-docs.pages.dev
Branch Preview URL: https://docs-azure-emulated-portal.localstack-docs.pages.dev

View logs

@DrisDary DrisDary added azure documentation Improvements or additions to documentation labels Sep 2, 2026
@DrisDary
DrisDary requested a review from a team September 2, 2026 08:55
@DrisDary

DrisDary commented Sep 2, 2026

Copy link
Copy Markdown
Contributor Author

This docs PR shouldn't merge before this pr

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

azure documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant