> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nsc ingress list

Lists the registered ingresses on the specified instance.

`ingress list` lists all the registered ingresses for an instance.
To expose an application in a preview, see our guides on [Container Previews](/docs/solutions/previews) and [Kubernetes Previews](/docs/solutions/previews/kubernetes).

## Usage

```bash theme={null}
nsc ingress list <instance-id> [--output <plain|json>]
```

### Example

In the example below, we first create an ephemeral instance, start nginx with `kubectl run`, create a Load Balancer with `kubectl expose` and then expose it
using `nsc expose kubernetes`.

<Steps titleSize="h4">
  <Step title="Create an ephemeral instance">
    Create an ephemeral instance and note its ID:

    ```bash theme={null}
    nsc create
    ```

    ```text nocopy Output theme={null}
      Created new ephemeral environment! ID: hk99v6hn1tk9m
    ```
  </Step>

  <Step title="Start nginx">
    Start nginx within the created instance:

    ```bash theme={null}
    nsc kubectl hk99v6hn1tk9m run nginx --image=nginx
    ```

    ```text nocopy Output theme={null}
    pod/nginx created
    ```
  </Step>

  <Step title="Create a load balancer">
    Expose the nginx pod through a Kubernetes load balancer:

    ```bash theme={null}
    nsc kubectl hk99v6hn1tk9m expose pod nginx --type=LoadBalancer --port=80
    ```

    ```text nocopy Output theme={null}
    service/nginx exposed
    ```
  </Step>

  <Step title="Expose port 80">
    Expose port 80 using `nsc expose kubernetes`:

    ```bash theme={null}
    nsc expose kubernetes hk99v6hn1tk9m --namespace=default --service=nginx --name=nginx-foobar
    ```

    ```text nocopy Output theme={null}
    Exported port 80 from default/nginx:
      https://nginx-foobar-hk99v6hn1tk9m.fra1.namespaced.app
    ```
  </Step>

  <Step title="List exposed ingresses">
    List the instance's exposed ingresses:

    ```sh theme={null}
    % nsc ingress list hk99v6hn1tk9m
    ```

    ```text nocopy Output theme={null}
    https://nginx-foobar-hk99v6hn1tk9m.fra1.namespaced.app (port: 80)
    ```
  </Step>
</Steps>

## Options

<h3 id="--output--o-format">
  \--output, -o \<format>
</h3>

Specifies the output format. Supported options are `json` and
`plain`. By default, plain output format is used.