---
title: "Creating the admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Creating the admin Object

This page is written for C++, C#, Java, MATLAB, PHP, Python, Ruby, and Swift.

Parts of this page are for some programming languages only, and name them. For one language's text alone, see [C++](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/java.md), [MATLAB](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/php.md), [Python](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/ruby.md), and [Swift](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object/swift.md).

The administrative facility is disabled by default. To enable it, you must set the property [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md#ice.admin.enabled) to `1`, or leave [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md#ice.admin.enabled) unset and specify endpoints for the `Ice.Admin` administrative object adapter using the property [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md). When [Ice.Admin.Enabled](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md#ice.admin.enabled) is set to `0`, the administrative facility is disabled, and `Ice.Admin.Endpoints` is ignored.

Ice creates the admin object during communicator initialization, and hosts all its [enabled facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md) in the built-in `Ice.Admin` object adapter, when:

- The administrative facility is enabled,
- The [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md) property specifies endpoints for the Ice.Admin object adapter, and
- The [Ice.Admin.DelayCreation](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md#ice.admin.delaycreation) property is not set, or is set to `0`.

Ice gives this object the identity `instance-name`/admin, where *instance-name* is the value of the [Ice.Admin.InstanceName](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md#ice.admin.instancename) property. If `Ice.Admin.InstanceName` is not set or empty, Ice generates a UUID for *instance-name*.

> **C++, C#, Java, Python, and Swift**
>
> An application that needs to add or replace administrative facets before the admin object exposes them, such as the [Process](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/process-facet.md) facet, sets `Ice.Admin.DelayCreation` to `1`, with `Ice.Admin.Endpoints` set as above: the communicator then creates the admin object when the application calls `getAdmin` on the Communicator ([C++](https://code.zeroc.com/ice/3.8/api/cpp/classIce_1_1Communicator.html), [C#](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.Communicator.html), [Java](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html), [Python](https://code.zeroc.com/ice/3.8/api/python/Ice.Communicator.html), and [Swift](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator)).

The endpoints of the object adapter that hosts the admin object determine which clients can reach it; see [Securing the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets.md).

> **C++, C#, Java, Python, and Swift**
>
> ## Hosting the admin Object in Your Own Object Adapter
>
> An application can host the admin object in one of its own object adapters instead of the `Ice.Admin` object adapter. Set `Ice.Admin.Enabled` to `1` and leave `Ice.Admin.Endpoints` unset, so that the communicator does not create the admin object during initialization. Then call `createAdmin` ([C++](https://code.zeroc.com/ice/3.8/api/cpp/classIce_1_1Communicator_a87511b9f8ea733ab31e6680ab8e1234f.html#a87511b9f8ea733ab31e6680ab8e1234f), [C#](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.Communicator.html#Ice_Communicator_createAdmin_), [Java](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html#createAdmin(com.zeroc.Ice.ObjectAdapter,com.zeroc.Ice.Identity)), [Python](https://code.zeroc.com/ice/3.8/api/python/Ice.Communicator.html#Ice.Communicator.createAdmin), and [Swift](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator/createadmin(adminadapter:adminid:))) with this object adapter and the identity of the admin object, and activate the object adapter.
>
> > **C++, C#, and Java**
> >
> > Because you create this object adapter, you can give it its own [SSL configuration](https://docs.zeroc.com/ice/3.8/runtime/ssl-transport.md), separate from the configuration of the communicator.

## See Also

- [Ice.Admin.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md)
- [IceGrid and the Administrative Facility](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md)
- [Securing the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets.md)
- [Using the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/using-the-admin-object.md)
