---
title: Removing the admin console
description: Remove the admin console from a PingDirectory deployment by deleting the console.war file and updating config.ldif.
component: pingdirectory
version: 10.3
page_id: pingdirectory:pingdirectory_server_administration_guide:pd_ds_remove_admin_console
canonical_url: https://docs.pingidentity.com/pingdirectory/11.1/pingdirectory_server_administration_guide/pd_ds_remove_admin_console.html
llms_txt: https://docs.pingidentity.com/pingdirectory/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-09-28T00:00:00Z
superseded_by: https://docs.pingidentity.com/pingdirectory/11.1/pingdirectory_server_administration_guide/pd_ds_remove_admin_console.html
section_ids:
  steps: Steps
  example: Example:
  example-2: Example:
  result: Result:
---

# Removing the admin console

This topic describes how to remove the admin console from PingDirectory after installation. You can configure and operate the PingDirectory server without the admin console by using the command-line interface (CLI). There aren't any server functions available from the admin console that aren't also available through the CLI.

## Steps

Follow these steps to remove the admin console from your PingDirectory deployment:

1. Stop the server.

   ### Example:

   ```
   $ bin/stop-server
   ```

2. Delete the following files and directory:

   * `webapps/console.war`

   * `resource/admin-console.zip`

   * `tmp/Console`

3. Edit the `config/config.ldif` file as follows:

   1. In the `dn: cn=HTTPS Connection Handler,cn=Connection Handlers,cn=config` section, remove the following line:

      ```
      ds-cfg-web-application-extension: cn=Console,cn=Web Applications,cn=config
      ```

   2. Delete the entire `dn: cn=Console,cn=Web Applications,cn=config` entry, including the following lines:

      ```
      dn: cn=Console,cn=Web Applications,cn=config
      objectClass: top
      objectClass: ds-cfg-web-application-extension
      objectClass: ds-cfg-console-web-application-extension
      ds-cfg-application-title: PingDirectory Admin Console
      cn: Console
      ds-cfg-description: The Administrative Console
      ds-cfg-base-context-path: /console
      ds-cfg-war-file: webapps/console.war
      ds-cfg-ldap-server: ldaps://<server-hostname>:<ldaps-port>
      ds-cfg-java-class: com.unboundid.directory.server.protocols.http.ConsoleWebApplicationExtension
      ds-cfg-log-file: logs/webapps/console.log
      ```

   3. Save your changes.

4. Start the server.

   ### Example:

   ```
   $ bin/start-server
   ```

## Result:

You have successfully removed the admin console from your PingDirectory deployment.

|   |                                                                                                                                                                                                                                                                                                                     |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | Upgrading the server after removing the admin console restores the `console.war` file but doesn't affect the console configurations that you removed from `config.ldif`. The admin console won't run with these configurations removed. Optionally, you can remove `console.war` after completing a server upgrade. |