---
title: "<server-instance> Element"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-instance-descriptor-element
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# \<server-instance> Element

A `server-instance` element deploys an instance of a [server-template](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-template-descriptor-element.md) element on a node. It may supply additional information such as [configuration properties](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/properties-descriptor-element.md).

This element may only appear as a child of a [node](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/node-descriptor-element.md) element.

The following attributes are supported:

| **Attribute** | **Description** | **Required** |
| --- | --- | --- |
| `template` | Identifies the server [template](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-templates.md). | Yes |

All other attributes of the element must correspond to [parameters](https://docs.zeroc.com/ice/3.8/services/icegrid/using-descriptor-variables-and-parameters.md) declared by the template. The `server-instance` element must provide a value for each parameter that does not have a default value supplied by the template.

Here is an example to demonstrate the use of this element:

```xml
<icegrid>
    <application name="SampleApp">
        <server-template id="ServerTemplate">
            <parameter name="id"/>
            <server id="${id}" activation="manual" .../>
        </server-template>
        <node name="Node1">
            <server-instance template="ServerTemplate" id="TheServer">
                <properties>
                    <property name="Debug" value="1"/>
                </properties>
            </server-instance>
        </node>
    </application>
</icegrid>
```

## See Also

- [Server-Template Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-template-descriptor-element.md)
- [Node Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/node-descriptor-element.md)
- [IceGrid Templates](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-templates.md)
- [Using Descriptor Variables and Parameters](https://docs.zeroc.com/ice/3.8/services/icegrid/using-descriptor-variables-and-parameters.md)
