> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging-feat-3pa-xaa-myorgs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Universal Portals Quickstart

> Learn how to set up your first portal using the Auth0 CLI or Auth0 Agent Skills.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Early Access"
  };
  const stageText = stageTextMap[stage] || "a product release stage";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>This feature is available for {linkify(`${plans} plans`, "https://auth0.com/pricing")}. </>}
            {contact && "To participate, contact " + contact + ". "}
            {terms && <>By using this feature, you agree to the applicable Free Trial terms in Okta's {linkify("Master Subscription Agreement", "https://www.okta.com/legal")}.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>The {feature} feature is in {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Universal Portals" stage="beta" terms="true" contact="Auth0 Support" />

You can create a portal using:

* [Auth0 CLI](/docs/deploy-monitor/auth0-cli#auth0-cli) to provision and configure an application and a portal using a single command.
* [Auth0 Agent Skills](https://github.com/auth0/agent-skills) to ask your favorite AI assistant to provision and configure an application and a portal.

## Prerequisites

* A [Development](/docs/get-started/tenant-settings#environment-tag) Auth0 tenant provisioned with Universal Portals beta access.

<Tabs>
  <Tab title="Auth0 CLI">
    ## Step 1: Install the Auth0 CLI Beta

    Follow the [installation instructions](https://github.com/auth0/auth0-cli/#linux-and-macos-1) for your platform, then authenticate with your tenant:

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      Homebrew users with the stable `auth0` CLI already installed: the beta binary is shadowed by your existing install. Add the following alias to your shell configuration for the commands in this guide to work as written:

      ```bash theme={null}
      alias auth0-beta="$(brew --prefix auth0-beta)/bin/auth0"
      ```
    </Callout>

    ```bash theme={null}
    auth0-beta login
    ```

    ## Step 2: Run the setup command

    ```bash theme={null}
    auth0-beta universal-portals setup
    ```

    You can also use the alias `auth0-beta up setup`. The Auth0 CLI command creates:

    * **My Account API**: resource server for user account operations
    * **My Organization API**: resource server for organization management operations
    * **A Regular Web App**: the application linked to your portal
    * **Three client grants**: scoped access for My Account, My Organization, and Management API operations
    * **A portal**: pre-configured with a default template so you can start testing immediately

    When the command completes, it outputs your portal URL. Open it in the browser to test the portal.
  </Tab>

  <Tab title="Auth0 Agent Skills">
    ## Step 1: Install Auth0 Agent Skills

    ```bash theme={null}
    npx skills add auth0/agent-skills
    ```

    ## Step 2: Ask your AI agent to configure Universal Portals

    ```bash theme={null}
    configure universal portals on my auth0 tenant
    ```

    The AI agent creates:

    * **My Account API**: resource server for user account operations
    * **My Organization API**: resource server for organization management operations
    * **A Regular Web App**: the application linked to your portal
    * **Three client grants**: scoped access for My Account, My Organization, and Management API operations
    * **A portal**: pre-configured with a default template so you can start testing immediately

    When the command completes, it outputs your portal URL. Open it in the browser to test the portal.

    To learn more, read [Auth0 Agent Skills](https://github.com/auth0/agent-skills).
  </Tab>
</Tabs>

## Learn more

<Card title="Universal Portals overview" icon="key" href="/docs/customize/portals/overview" horizontal>
  Learn about Universal Portals, use cases, how it works, and key features.
</Card>

<Card title="Universal Components" icon="key" href="/docs/get-started/universal-components/universal-components-overview" horizontal>
  Learn about Universal Components library used in portals.
</Card>

<Card title="Auth0 Forms" icon="key" href="/docs/customize/forms" horizontal>
  Learn about Forms to collect information from end-users, such as profile updates, policy acceptance, and marketing communication preferences in portals.
</Card>