> For the complete documentation index, see [llms.txt](https://docs.one-click.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.one-click.dev/platform/network.md).

# Network

For the network, you have a few options to configure. You can define as many services and ingress interfaces as you want. The services are the internal Kubernetes services and the ingress is the external access to your services. To create a new network interface you can click the **New Interface** button.

<figure><img src="/files/D8Cr7D6zslRx8pG54dIU" alt=""><figcaption><p>new interface</p></figcaption></figure>

You can define the following options:

* name: the name of the interface, must be unique in the **deployment**
* port: the port of the interface (take your application port, defined in the Dockerfile)
* ingress class: the ingress class of the interface (the dropdown will show you the available ingress classes inside the Kubernetes cluster)
* host: the host of the interface (e.g. example.com)
* path: the path of the interface (e.g. /api, /)
* tls: if you want to use TLS you can toggle the switch and define the secret name
* (tls secret name: the secret name of the TLS certificate) if not defined it will default to the host name -> use case: you want to auto-generate the TLS certificate with cert-manager annotation

The <mark style="color:green;">**DNS name**</mark> is the actual Kubernetes Service name in the cluster. This name you can use in other deployments to connect to the service via DNS lookup. (click on the copy icon to copy the name).

<figure><img src="/files/MUmmBssO0GLByWjrYiZ0" alt=""><figcaption><p>interfaces overview</p></figcaption></figure>

{% hint style="info" %}
If you set the ingress class to **none**, **remove** the host and path and disable the TLS switch, the ingress will get deleted and only the service will get created. This is useful if you want to expose the service only internally for other services **inside** the Kubernetes cluster.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.one-click.dev/platform/network.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.