---
title: "<icebox> Element"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/icebox-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).

# \<icebox> Element

An `icebox` element defines an [IceBox](https://docs.zeroc.com/ice/3.8/services/icebox.md) server to be deployed on a node. It typically contains at least one [service](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/service-descriptor-element.md) element, and may supply additional information such as [command-line options](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/using-command-line-options-in-descriptors.md), [environment variables](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/setting-environment-variables-in-descriptors.md), and [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 or a [server-template](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-template-descriptor-element.md) element.

This element supports the same attributes as the [server](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-descriptor-element.md) element.

An optional nested [description](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/description-descriptor-element.md) element provides free-form descriptive text.

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

```xml
<icebox id="MyIceBox"
        activation="on-demand"
        activation-timeout="60"
        deactivation-timeout="60"
        exe="/opt/Ice/bin/icebox"
        pwd="/">
    <option>--Ice.Trace.Network=1</option>
    <env>PATH=/opt/Ice/bin:$PATH</env>
    <property name="IceBox.UseSharedCommunicator.Service1" value="1"/>
    <service name="Service1" .../>
    <service-instance template="ServiceTemplate" name="Service2"/>
</icebox>
```

## See Also

- [IceBox](https://docs.zeroc.com/ice/3.8/services/icebox.md)
- [Service Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/service-descriptor-element.md)
- [Adapter Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/adapter-descriptor-element.md)
- [Properties Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/properties-descriptor-element.md)
- [Node Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/node-descriptor-element.md)
- [Server-Template Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-template-descriptor-element.md)
- [Server Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/server-descriptor-element.md)
- [Description Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/description-descriptor-element.md)
- [Using Command Line Options in Descriptors](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/using-command-line-options-in-descriptors.md)
- [Setting Environment Variables in Descriptors](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/setting-environment-variables-in-descriptors.md)
- [Administrative Facility](https://docs.zeroc.com/ice/3.8/administration/administrative-facility.md)
