> 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="https://3601602753-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclSnVNQ9cQ3UGmpo9Q9i%2Fuploads%2FWaSwlsmFJGgEIb653oYk%2Fimage.png?alt=media&amp;token=d5ef0af8-3ea1-4ca2-8337-267f93f5d930" 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="https://3601602753-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclSnVNQ9cQ3UGmpo9Q9i%2Fuploads%2FmfXbi8kAcnaMpBCkgs0X%2Fimage.png?alt=media&amp;token=015bd19d-09ff-4dad-b1e9-7cdf33fc5780" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
