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

# Endpoints

> What are Endpoints? Endpoints are the FlexDeploy representation of a device or virtual machine where plugins can be executed. They hold connection and

# What are Endpoints?

Endpoints are the FlexDeploy representation of a device or virtual machine where plugins can be executed. They hold connection and host details that allow FlexDeploy to connect to and perform commands on the server.

FlexDeploy utilizes an agent-less as well as agent-based architecture to connect to computers across private or public networks/clouds to execute build and deploy operations. This architecture uses a secured communication protocol (SSH) or HTTPS. If HTTPS protocol is desired then [agent installation](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-https-agent/flexdeploy-https-agent-installation-guide.md) is necessary. SSH connectivity eliminates the need for installing and managing software(agent) on every build and deployment target.

# Endpoint Requirements

* See [System Requirements](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-system-requirements.md) for information about Endpoint Requirements.

# Viewing Endpoints

To view the configured Endpoints, select ***Topology*** from the menu, and then choose the ***Endpoints*** tab.

![image-20260420-055202.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911360.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=74420de212a2088353d038e842a31bdd)

If you want to search the Endpoint , by clicking on filter symbol on different columns like Active, Name, Address, Description, Updated By, Updated On .

![image-20260420-055327.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911357.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=807419532f8e52a90d38ee7ee5a6b1e4)

# Creating and Editing Endpoints

See the following links for information on creating Endpoints.

> [!NOTE]
>
> See [Endpoint Defaults](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/administration/defaults/endpoint-defaults.md) to setup default values for new Endpoints to save time.

* [Creating an SSH Endpoint](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/topology/endpoints/creating-an-ssh-endpoint.md)

* [Creating a LocalHost Endpoint](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/topology/endpoints/creating-a-localhost-endpoint.md)

* [Creating an HTTPS Endpoint](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/topology/endpoints/creating-an-https-endpoint.md)

# Endpoint Tags

To add a [***Tag***](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/administration/tags.md) to the Endpoint , click on the three dots that we are seeing on right side of the particular endpoint row.

![image-20260420-055427.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911354.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=ed31109f84debb3fe03170a622cb10d4)

After clicking on the Add Tag option, then you can see a list of already created tags , by clicking on a tag from the list of tags such tag will be assigned to selected Endpoint.

![image-20260420-055821.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590911351.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=f9083f1de1c3246460d9662ac1378a87)

To Manage the Tags you can navigate to ***Tags*** from the ***menu*** and manage the Tags [Tags | Managing Tags](https://docs.flexagon.com/flexdeploy-11-1-documentation/flexdeploy-users-guide/administration/tags.md#Managing-Tags) .

# Activating and Inactivating Endpoints

To inactivate an Endpoint click the ***Active*** link on the desired endpoint, and it will toggle to ***Inactive***. This will hide that Endpoint after leaving the screen, until the ***Active*** checkbox is unchecked. To reactivate an Endpoint, click the ***Inactive*** link and it will toggle back to ***Active***

# Endpoint Directory Structure

FlexDeploy creates and manages the following directory structure on the endpoints.

> [!NOTE]
>
> Note that the permissions on this folder structure is 755 and must not be made less restrictive. Also, this folder structure is mostly owned by Endpoint User or Run As User.

Files whose names start with a period (hidden/dot files) are not retrieved from the endpoint when FlexDeploy copies artifacts, reports, scan results, or test results back to the server.

**plugins**\
The plugins directory holds each version of a plugin that has been executed on the Endpoint. There can be several different plugins loaded and several versions of a given plugin. FlexDeploy will automatically purge older plugin versions, and redistribute them if an older version is later activated.

**scratch**\
Internal directory which is used for file transfer and managing permissions. Applicable only when using "Run As User" on the endpoint to execute commands as another privileged user.

> [!NOTE]
>
> The scratch folder is only created when using "Run as User" for the endpoint. This folder is created and owned Endpoint user, whereby all other directories are owned by the Run As User. This is required to facilitate the upload/download of files which are performed using the endpoint user.

**security**\
The security directory holds information related to the SSH connection between the FlexDeploy server and the Endpoint server and is used for secure communications.

**work**\
The work directory contains every invocation of a plugin operation that has occurred on the Endpoint. There is additional file structure under the work directory based on the execution project id and the current execution id of the given project.

**work/\<projectId>/\<executionId>/artifacts**\
Directory where artifacts are stored so they can be transferred back to the FlexDeploy server and stored permanently in the artifact repository.

**work/\<projectId>/\<executionId>/internal**\
Directory where all internal FlexDeploy scripts are stored to execute the plugin step.

**work/\<projectId>/\<executionId>/object-results**\
Directory utilized by partial deployment plugins to transfer the deployment status of each file back to the FlexDeploy server.

**work/\<projectId>/\<executionId>/reports**\
Directory to write any report files during Build, Pre-deploy, Test or Deploy operations. The Report file size can be controlled from the Administration → System Settings page. Files are returned to the FlexDeploy server and processed.

**work/\<projectId>/\<executionId>/scan-results**\
Directory for security scanning plugins (e.g. OWSAP, SonarQube) to place the scan results to be returned to the FlexDeploy server and processed.

**work/\<projectId>/\<executionId>/temp**\
Directory for plugin execution to checkout and manipulate data or files until moved to the artifacts directory for storage.

**work/\<projectId>/\<executionId>/test-results**\
Directory for test plugins (e.g. Junit, Postman) to place the test results to be returned to the FlexDeploy server and processed.

**work/\<projectId>/\<executionId>/transfer**\
Directory used to return file from a plugin execution and feed as input into another plugin operation. This directory is only used in very specific use cases.

**work/\<projectId>/\<executionId>/backups**\
Directory used to backup a file from a plugin execution and put it into the backups repository.
