> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/fabricate/workspaces/workspace-server-connections/server-connection-add-edit-delete.md).

# Adding, editing, and deleting server connections

## Adding a server connection

From the **Server Connections** list, to add a server connection:

1. Click **Add Server Connection**.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FMVBr1h9i1IkRAknfgCVS%2FWorkspace_NewServerConnection.png?alt=media&amp;token=a3a851ff-dc9c-4a18-b441-76a113339c82" alt=""><figcaption><p>New Server Connection panel to create a server connection</p></figcaption></figure>

2. On the **New Server Connection** panel, to use a connection string to populate the connection fields, in the **Connection URL** field, paste the string.\
   \
   When it uses a connection string to populate the fields, Fabricate sets **Name** to the host value. You can change the name to a different value.
3. If you do not use a connection string, then:
   1. Under **Platform**, click the server platform.
   2. In the **Name** field, provide a name to use to identify the server connection.
   3. Provide the [connection details](/fabricate/workspaces/workspace-server-connections/server-connection-details.md).
4. To test the connection, click **Test Connection**.

   \
   Note that for Google BigQuery, Fabricate prompts you to provide a dataset to use for the connection test.
5. To save the connection, click **Create Server Connection**.

## Editing a server connection

To edit a server connection:

1. Click the edit icon for the server connection.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2F4JIksxYXMEhfkHOtCo4X%2FWorkspace_EditServerConnection.png?alt=media&amp;token=a2f90a9a-68a0-4a6e-bdaf-73b6d5d70c03" alt=""><figcaption><p>Edit Server Connection panel</p></figcaption></figure>

2. On the connection details panel, update the [connection details](/fabricate/workspaces/workspace-server-connections/server-connection-details.md).\
   \
   Note that Fabricate does not display the existing content of password, secret, or private key fields. If you are not changing those values for a server connection, then leave the field empty.
3. To test the updated configuration, click **Test Connection**.
4. To save the changes, click **Save Changes**.

## Deleting a server connection

You cannot delete a server connection that is either:

* Used in a database connection.
* The server connection for a database export target. Before you can delete the server connection, you must remove the export target.

From the **Server Connections** list, to delete a connection, click its delete option.


---

# 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.tonic.ai/fabricate/workspaces/workspace-server-connections/server-connection-add-edit-delete.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.
