> For the complete documentation index, see [llms.txt](https://docs.copia.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.copia.io/docs/devicelink/basic/cognex/cognex-in-sight.md).

# Cognex In-Sight

## Overview

Cognex In-Sight cameras can be backed up with Copia DeviceLink using the [FTP](https://docs.copia.io/docs/devicelink/basic/copia-ftp.md) integration. Every In-Sight camera has an integrated FTP server, and a Copia FTP project retrieves the camera files on a scheduled Job.

There are two files to back up: the main project `.job` file and the camera settings `proc.set` file. FTP is the only method for saving the `proc.set` file.

## Requirements

Below are the requirements to configure a Copia Agent for the backup of Cognex In-Sight:

* An In-Sight user account with **FTP Read** access to the camera (see below).
* Network access from the Copia Agent to the camera on the FTP port (21).
* The Agent should be tested to confirm that it can backup the desired files via an FTP Client.

## Cognex In-Sight Configuration

Each In-Sight camera has its own User List, separate from every other camera on the network. Copia logs in to the camera's FTP server with a user from that list.

#### Create an FTP user for Copia

1. Connect to the camera in In-Sight Explorer.
2. From the **Sensor** menu, select **User Access Settings**.
3. Click **Add** and enter a User Name and Password (User Name 1–15 characters, Password 0–15 characters; letters, digits, `_` and `-`).
4. Select an Access level and enable **FTP Read (FTP-R)**.
5. Click **OK**.

{% hint style="info" %}
The default `admin` account has Full access and can also be used. Its access level and FTP privileges cannot be modified.
{% endhint %}

#### Verify FTP access

From the Copia Agent, connect to the camera with an FTP client using the camera IP address and the user created above. Run `dir` and confirm that the `.job` file(s) and `proc.set` are listed.

{% hint style="warning" %}

* A camera allows a maximum of **two FTP connections** at any one time. Make sure other FTP clients are not connected when the Copia Job runs.
* Camera performance may be degraded when files are saved or loaded while the camera is **Online**. Schedule Jobs at a time when this is acceptable.&#x20;
  {% endhint %}

## Project Configuration

{% hint style="info" %}
FTP projects require a [File List](https://docs.copia.io/docs/devicelink/sitesandagents/sites/file-lists.md) to determine what files on the device to include/exclude, or exclude from compare. Copia does not provide a default FTP file list, as every device is unique. **It is recommended** to add a file list for the device type prior to creating a project, as it will be required prior to backup operations.
{% endhint %}

To configure a Cognex In-Sight project, you need a repository with a folder to store the device data. The folder is usually named similar to the target device.

Click either of the *Add a Project* buttons in the Projects tab.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2Feypby4vgqCII6fDBdsqh%2Fimage.png?alt=media&amp;token=17a20355-331c-4073-b542-c13dbb8cebce" alt=""><figcaption></figcaption></figure>

The *Add a new project* configuration dialog will appear which allows you to fully configure the project, devices and job for the project.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FrMjsrsfbEWUdBR6Jq8RY%2Fimage.png?alt=media&amp;token=c8a2c458-4f12-4b22-8aa2-70397a587ad2" alt=""><figcaption></figcaption></figure>

#### Define the Project

To get started, select **FTP** as the *Project Type*, and then select an *Agent*. If you have not already created an Agent, you can create and assign an Agent at a later time. See more about this in the [Agents ](https://claude.ai/docs/devicelink/sitesandagents/agents.md)section of the documentation.

When complete, press *Save and Continue*.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2F0CPf7iuGnDPGdYDtV1Dr%2Fimage.png?alt=media&amp;token=b32ee7d0-4e16-486e-821f-4eb860196baa" alt=""><figcaption></figcaption></figure>

You will now select the Project Path, which is the location (Repo/Branch) that the project is, or will be stored.&#x20;

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FKFHyNuPKqDQGIqgOLF8U%2Fimage.png?alt=media&amp;token=75ce5778-68ba-458d-a297-97f82e0a72a5" alt=""><figcaption></figcaption></figure>

You can either select an existing folder, or create a new empty folder. Once complete, press *Save and Continue* to proceed.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2Fzf18QoIS5Ea9nsQ7qS77%2Fimage.png?alt=media&amp;token=fae40663-2e6e-4737-b9e7-f86aab0ea795" alt=""><figcaption></figcaption></figure>

The project details allows you to update the Project name, and description if desired, and select the **File List**.

Select a pre-existing file list, or press the *Create a file list* link to create one with:

* **Name:** `Cognex_InSight`
* **Project Type:** FTP
* **Include in Backup:** `*.job`, `proc.set`

Press *Save and Continue* to proceed.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FPARSvNDpazFNe9xhJFci%2Fimage.png?alt=media&amp;token=5d50f95c-4b84-4357-b1fb-5cd6423f5af1" alt=""><figcaption></figcaption></figure>

#### Define the Device

The Device Setup section is for defining the device information (IP address, authentication, etc.) that is in your project. If you have pre-created devices, you can add existing devices, otherwise you can *Add a Device* as seen.

* **Host / IP Address:** {camera IP address}
* **Username / Password:** {In-Sight user credentials}
* **Start Directory:** leave blank (the camera files are in the FTP login folder)

Press *Save Device* when complete.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FfIw91frVXQy0XW7JFcr5%2Fimage.png?alt=media&amp;token=78663bb6-ee22-4ada-9419-e5ab8b7d4d4a" alt=""><figcaption></figcaption></figure>

#### Define the Job

Creating Jobs is similar for all vendor types, and is described in the [Creating Jobs](https://docs.copia.io/docs/devicelink/jobs/creating-jobs.md) section. It is recommended to review that section while completing a job configuration, and press Save to save the job. You can create more than one job for a device if desired.

#### Submit the Configuration

Once complete, press *Submit Project Setup* to create the Project, Device(s) and Job(s).

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2F4uEtp61pjRqWdi45NzXu%2Fimage.png?alt=media&amp;token=0137b738-dd96-4ee9-b0a3-a017bebe8274" alt=""><figcaption></figcaption></figure>


---

# 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.copia.io/docs/devicelink/basic/cognex/cognex-in-sight.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.
