> For the complete documentation index, see [llms.txt](https://docs.tessell.com/tessell/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tessell.com/tessell/database-engines/tessell-for-sqlserver/db-services/my-services/database-service-home-page/overview.md).

# Overview

The Overview tab is the primary connection hub for your SQL Server database service. It displays everything needed to connect client applications, manage network access, configure private links, and control public accessibility.

***

## How do I get the connection details for my database service?

| Field           | Description                                                                                                                                                                                                                                                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Host**        | Hostname in the format `<service-name>-<suffix>.<domain>`. For HA services, Tessell keeps this DNS pointing to the current primary — applications should always use this hostname. Click the edit icon to rename the DNS (single-instance only); click copy to copy it. |
| **Connect to**  | Indicates connections go to the Database.                                                                                                                                                                                                                               |
| **Database**    | Database name for connection strings. Click copy to copy it.                                                                                                                                                                                                            |
| **Username**    | Default username, chosen during migration. Click copy to copy. Tessell manages only this user — additional schema users created during migration remain valid but are not managed by Tessell.                                                                           |
| **Password**    | Set or reset the master password here. Click the eye icon to reveal the current password (encrypted by default).                                                                                                                                                        |
| **Port**        | Database listener port. Click copy to copy.                                                                                                                                                                                                                             |
| **Service URL** | Full connection URL. Each instance, database, and connection pooler gets its own URL.                                                                                                                                                                                   |

> **Note:** Tessell supports DNS names without the suffix (format: `<servicename>.<domain>`). Contact Tessell support to enable this.

***

## How do I enable SSL/TLS for my database connection?

The **CA certificate** section appears when SSL was enabled at provisioning. It lets you view, download, or copy the certificate.

***

## How do I get SSH access to the database VM?

VM access is granted through a bastion host that must be deployed in the same network as the database service (or a network with access to the database subnet). Access is time-limited and request-based.

### Steps to request VM access

1. Click **Request** in the **VM access** section.
2. Select the instances to grant access to:
   * **All computes at service level** — includes the controller node.
   * **Default primary node** — primary instance only.
   * **Replica nodes** — if any exist.
3. Choose a duration (in hours) from the dropdown.
4. Specify the reason for access.
5. Enter the allowed IP address (private IP of your bastion host — only private IPs are allowed).
6. Click **Request**.
7. After the request is approved, click **Connect** and download the access key.
8. Use the key and instructions in the downloaded folder to SSH into the VM.

***

## How do I control which IP addresses can connect to my database?

The **Allowed IP addresses** section lists the client IPs from which connection requests are accepted (database port only).

1. Click the edit icon next to **Allowed IP addresses**.
2. In the **Update Connectivity** window, add or remove IP addresses. The dialog shows your current client IP.
3. Click **+ Add current client IP** to add your own IP automatically.
4. You can also add CIDR blocks to allow a range of addresses.
5. Click **Update** to apply.

**Publicly accessible** is disabled by default (Yes/No). To enable or disable it: click the edit icon next to **Publicly accessible** → toggle the value → click **Update**. Public access cannot be enabled if the VPC/VNet is configured for private access only.

***

## How do I configure AWS PrivateLink for my database service?

AWS PrivateLink provides a private connection from your AWS VPC to the Tessell database service without traversing the public internet. For HA services, the private link automatically routes to the current primary instance during switchovers.

### Steps to configure AWS PrivateLink

1. Click the edit icon next to **AWS Private Link** → the **Private Link** window opens.
2. Enter the ARN(s) of allowed AWS principals. Accepted formats:
   * AWS account (includes all principals within the subscription): `arn:aws:iam::<account-id>:root`
   * Specific IAM user: `arn:aws:iam::<account-id>:user/<user-name>`
   * Specific IAM role: `arn:aws:iam::<account-id>:role/<role-name>`
3. Click **Create**. The status changes to **Updating**.
4. Wait for the **service endpoint name** to appear (e.g., `com.amazonaws.vpce.us-east-1.vpce-svc-0e123abc`). Copy it.
5. In the AWS console, navigate to **VPC** → **Endpoints** → **Create endpoint**.
6. Choose **Other endpoint services**, paste the service endpoint name, and click **Verify service**.
7. Select the VPC and subnets where your client machine resides (select all subnets you access the service from).
8. Select **IPv4** for IP address type → click **Save**.
9. Once the endpoint status is **Available**, note the DNS name without the region suffix (first in the DNS names list, under the VPC Details tab).
10. Use this DNS name as the host in your connection string, and connect over SSH.

***

## How do I configure Azure Private Link for my database service?

Azure Private Link provides a private connection from your Azure VNet to the Tessell database service. For HA services, it automatically routes to the current primary during switchovers. A dedicated private link is required for DR/RR instances.

### Steps to configure Azure Private Link

1. Click the edit icon next to **Azure Private Link** → the **Private Link** window opens.
2. Enter the allowed Azure subscription ID and press **Enter**.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-d5b3b1646444b528fa13c5f42f0a1b43f8b3ed8b%2Funknown.png?alt=media" alt=""></div>

3. Click **Create**. Wait for the service endpoint to appear and copy it.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-50297db3ed02021725a6964281d0afe6a147b3de%2Funknown.jpeg?alt=media" alt=""></div>

4. In the Azure portal, navigate to **Private endpoints** (**Network foundations → Overview → Private Link → Private endpoints**) → **+ Create**.
5. On the **Basics** tab: choose a resource group, enter a name, optionally set a network interface name (defaults to `<private endpoint name>-nic`), and select a region.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-d3354ef3b98f26fcf699e93b8d8b37ea23bba35f%2Funknown.jpeg?alt=media" alt=""></div>

6. On the **Resource** tab: select **Connect to an Azure resource by resource ID or alias**, paste the Tessell service endpoint, and optionally add a request message.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-7e8087f00e6428515e060896ec2418a766a14cd1%2Funknown.jpeg?alt=media" alt=""></div>

7. On the **Virtual Network** tab: select your virtual network and subnet.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-dc1b2b12715fad53a151a102386200af91bbf617%2Funknown.jpeg?alt=media" alt=""></div>

8. Leave **DNS** as default → optionally add tags → click **Create**.
9. After Tessell approves the connection request, the connection state changes to **Approved**.
10. Note the private IP of the private endpoint and use it as the hostname in your service URL.

***

## What are Tags on the Overview tab?

The **Tags** section displays key-value pair tags assigned to the database service. A unique tag is assigned at provisioning time. Editing tags post-provisioning is not propagated to underlying cloud resources (planned feature).

***

## What does the Refresh History section show?

The **Refresh History** section is displayed only for cloned services. It shows the last refreshed date and time for the clone.

<div align="center"><img src="https://3421475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNKiIctERJykfezXfUU2%2Fuploads%2Fgit-blob-2bf638db9887f0bb059629089ab0de480511ae66%2Foverview.jpg?alt=media" alt=""></div>

<p align="center"><em>Figure 3 — Overview tab</em></p>


---

# 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.tessell.com/tessell/database-engines/tessell-for-sqlserver/db-services/my-services/database-service-home-page/overview.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.
