---
title: "Project instances"
canonical: "https://docs.cuesystem.com/space/TAM/1382187022/Project%20instances"
format: markdown
---
You can read a **general introduction** to the projects [here](https://cue.atlassian.net/wiki/spaces/TAM/pages/1374781487). 

Project instances work with the project description contained in the uploaded *cuesolutionproject* file ([Explore in project general](https://cue.atlassian.net/wiki/spaces/TAM/pages/1382187012)). If you modify this file, the view in this tab will also be modified, adding new units, updating parameters for paired units, and deleting units missing in the project.

> ℹ️ **CUEunit** is defined by its **name**, if you don't want to lose the settings, **don't change the CUEunit instance name in the CVC** with the project version, it is used to pair with the values stored in the CUE Solution.

To create a new project instance click **NEW**. 

![image-20241011-143230.png](media://508faabb-f920-4267-b852-56b2bf2ff401)

To **edit new or an existing instance**, expand the selected instance with the **+ **button on the left. You can expand and collapse individual instances in the list using the **+** and **-** buttons on the left.

Then you can edit the existing or new project instance.

![image-20241011-180643.png](media://cf532701-491b-4aeb-9e2b-97a37c905633)

#### Project instance name

In this field (highlighted in red in the screenshot), type the name of the instance.

#### CUEunit instance name, Product model, Product code

These fields are read-only and indicate the instance name of the unit in *cuesolutionproject*, the model of the controller or touch panel and the product code.

#### Assigned unit (magic name)

Here, use the drop-down list box to select the unit that will be used in the instance. The unit must be created in the [Units list](https://cue.atlassian.net/wiki/spaces/TAM/pages/562888713).

#### Status of unit

This field is read-only. The status of the unit is displayed here:

- **Online** - The unit is registered, functioning and communicating regularly with the CUE Solution server.
- **Offline** - The unit is registered but does not communicate with the CUE Solution server. It may either be down, or for some reason it cannot communicate.
- **Unregistered** - The unit has been created in CUE Solution but is not yet registered, i.e. it has not yet been connected to CUE Solution.
- **Unassigned** - No unit from list of units in the CUE Solution is assigned.

#### Unit IP address

This read-only field displays the current or last known IP address of the unit. Clicking on it will open the unit's admin web in a new tab in the browser. This only works when the IP address is accessible from your computer. 

#### Application

This read-only field evaluates last information about the running application from the unit with information stored in the CUE Solution.

- **not running**: the app is not running
- **running up to date**: the unit is running the same application as is set up in the CUE Solution
- **running not up to date**: there is an outdated application running on the unit, probably it has not been updated yet
- **different {name}**: the unit is running a different application than the one set up in the CUE Solution

## Instance Status and Development Mode

![image-20241011-180500.png](media://9bf98c5b-8efd-4aa6-80d5-b10e8e68b207)

There are additional items at the top level of the instance:

#### Status

This shows the summary status of the units in the instance:

- **Online** - All control system units are switched on and communicate regularly with the CUE Solution server.
- **Some offline** - Some or none of the control system units from the instance do not communicate with the CUE Solution server.
- **Some unregistered** - Some of the unit from the instance has been created in CUE Solution but is not yet registered, i.e. it has not yet been connected to CUE Solution.
- **Some unassigned** - Some of the units in the project instance have not been mapped to a unit from the list of units in the CUE Solution.

#### Developer mode

If you enable Developer mode with this checkbox, the programmer will be able to upload, debug and edit projects directly from Cue Visual Composer. The project in CVC will then use the parameters and units set directly in CVC. This option is useful when creating projects, **we recommend to disable Developer mode after finalization**.

---

Don't forget to save your changes via the  button.