# Administration and Settings

> Set up a new DS Server: change the admin password, register the license, create security profiles and enable OAuth in the admin portal or with the Web API.

- **Product:** DS Server
- **Section:** Documentation
- **Kind:** Topic
- **Path:** DS Server > Administration and Settings
- **1087 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/administration/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/administration/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/administration/llms-full.txt

---

After you install DS Server, a few administrative tasks make it ready for your applications: securing the admin portal, registering the license, creating the credentials each application uses and switching on the token check. Each task is done in the admin portal, and each can be automated with the Web API and the `TXTextControl.DocumentServices.Admin` package.

### The Admin Portal

The admin portal is the web interface of DS Server. It is at the root of the service URL, for example `http://localhost:5000/`, and is protected by the admin user name and password, which your browser asks for in its own sign-in dialog. The navigation bar leads to every part of it:

| Menu item | What you do there | Page |
|---|---|---|
| **Security Profiles** | Create, edit and delete security profiles, and switch OAuth on or off | [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt), [Enable OAuth](https://docs.textcontrol.com/ds-server/administration/oauth/llms-full.txt), [OAuth Grant Types](https://docs.textcontrol.com/ds-server/administration/oauth-grant-types/llms-full.txt) |
| **Licensing** | Register, renew and unregister the license of this server | [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt) |
| **Authentication** | Register other DS Server instances as authentication servers | [Authentication Servers](https://docs.textcontrol.com/ds-server/administration/authentication-servers/llms-full.txt) |
| **Plugins** | See the installed plugins with their name, version, description and state | [Plugins](https://docs.textcontrol.com/ds-server/plugins/llms-full.txt) |
| User icon, **Admin Password** | Change the admin password | [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt) |

The **Welcome to DS Server** page opens after you sign in. Its **Typical Tasks** tiles lead to **Security Profiles**, **Licensing** and **Authentication Servers**, and the footer shows the version of DS Server, such as "DS Server version 5.0.2".

![The welcome page of the admin portal](https://docs.textcontrol.com/assets/img/ds-server/portal-welcome.63bc002c.webp)

The **Plugins** page only lists what DS Server loaded at its start from the *Plugins* folder, or "No plugins installed."; plugins are installed by copying files, as [Plugins](https://docs.textcontrol.com/ds-server/plugins/llms-full.txt) describes.

### Find the Right Page

| If you want to | Read |
|---|---|
| Sign in for the first time and replace the default password | [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt) |
| Register DS Server with your serial number, online or without Internet access | [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt) |
| Create the client ID and client secret for an application and add its redirect URIs | [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt) |
| Make DS Server require access tokens | [Enable OAuth](https://docs.textcontrol.com/ds-server/administration/oauth/llms-full.txt) |
| Choose between the authorization code and the client credentials flow | [OAuth Grant Types](https://docs.textcontrol.com/ds-server/administration/oauth-grant-types/llms-full.txt) |
| Let several DS Server instances accept each other's tokens | [Authentication Servers](https://docs.textcontrol.com/ds-server/administration/authentication-servers/llms-full.txt) |

### Where to Start

On a new installation, work through the tasks in this order:

1. Change the admin password, before anything else: [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt).
2. Register the license, because an unregistered server processes no documents: [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt).
3. Create a security profile for each application: [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt).
4. Enable OAuth, once your applications have their credentials: [Enable OAuth](https://docs.textcontrol.com/ds-server/administration/oauth/llms-full.txt).

### Automate the Administration

Every task except the plugins has a Web API equivalent: the [Administration](https://docs.textcontrol.com/ds-server/reference/web-api/administration/llms-full.txt) and [Licensing](https://docs.textcontrol.com/ds-server/reference/web-api/licensing/llms-full.txt) endpoints. They take the admin user name and password in a Basic `Authorization` header, not an OAuth token, so scripts can set up new servers without the portal. In .NET, the `TXTextControl.DocumentServices.Admin` package wraps the administration endpoints in the `Admin` class; [ASP.NET Core](https://docs.textcontrol.com/ds-server/client-libraries/aspnet-core/#admin) lists its methods. It has no methods for licensing.

### Pages in This Section

- [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt): sign in to the admin portal and change the default password.
- [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt): register a server online, manually or with the Web API, and what an unregistered server does.
- [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt): create, edit and delete the client credentials of your applications.
- [Enable OAuth](https://docs.textcontrol.com/ds-server/administration/oauth/llms-full.txt): switch the token check on and off, and what it changes.
- [OAuth Grant Types](https://docs.textcontrol.com/ds-server/administration/oauth-grant-types/llms-full.txt): the authorization code and the client credentials flow, and how to request tokens with each.
- [Authentication Servers](https://docs.textcontrol.com/ds-server/administration/authentication-servers/llms-full.txt): share token validation between several DS Server instances.

---

## In This Section

- [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt): Sign in to the DS Server admin portal with admin/admin and change the password in the portal, with the Web API or the Admin package, or reset it via Admin.db.
- [Authentication Servers](https://docs.textcontrol.com/ds-server/administration/authentication-servers/llms-full.txt): Let several DS Server instances accept each other's access tokens: register authentication servers in the admin portal, with the Web API or the Admin package.
- [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt): Register DS Server with your serial number online in the admin portal, manually with a license request string, or with the /license endpoints of the Web API.
- [OAuth Grant Types](https://docs.textcontrol.com/ds-server/administration/oauth-grant-types/llms-full.txt): Choose the authorization code or client credentials grant type of DS Server and request and refresh access tokens with /oauth/authorize and /oauth/token.
- [Enable OAuth](https://docs.textcontrol.com/ds-server/administration/oauth/llms-full.txt): Switch on the OAuth token check of DS Server in the admin portal or with SetOAuthEnabled, what it protects, when to leave it off and how to test it with cURL.
- [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt): Create OAuth security profiles with a client ID, client secret and redirect URIs in the admin portal, with the /admin/securityprofiles endpoints or in C#.

---

## Nearby

- **Previous:** [JavaScript](https://docs.textcontrol.com/ds-server/getting-started/document-viewer/javascript/llms-full.txt)
- **Next:** [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt)
