---
title: "GrantID on-premises"
description: "Hosting your own GrantID instance: supported platforms (Windows Server, Linux, Azure App Services, Docker) and domains to define before installing."
canonical: "https://docs.lacunasoftware.com/en-us/articles/grant-id/on-premises"
locale: "en"
product: "GrantID"
last_updated: "2026-07-14"
---

# GrantID on-premises

[GrantID](https://docs.lacunasoftware.com/en-us/articles/grant-id) can be used as a service (SaaS) at [grantid.com](https://grantid.com) or you can host your own instance.

## Supported platforms

GrantID is compatible with:

* [Windows Server](https://docs.lacunasoftware.com/en-us/articles/grant-id/on-premises/windows)
* [Linux](https://docs.lacunasoftware.com/en-us/articles/grant-id/on-premises/linux)
* [Azure App Services](https://docs.lacunasoftware.com/en-us/articles/grant-id/on-premises/azure)
* [Docker](https://docs.lacunasoftware.com/en-us/articles/grant-id/on-premises/docker)

Click on one of the platforms above for specific setup instructions.

## Planning before installation

Before you start, you should have the following public domains defined and created on the corresponding DNS servers, pointing to the server
that will host your GrantID instance:

* **Base domain**: base domain of the sites where users sign in.
* **Login domain**: hosts the actual site where users sign in. Must be a subdomain of the base domain.
* **Console domain**: hosts the dashboard that system administrators will use to configure GrantID itself.
* **API domain** (optional): hosts the GrantID API. The API does not need to be publicly accessible, so this is optional.

For instance, suppose you choose **id.yourcompany.com** as the base domain:

Domain type | Chosen domain name
----------- | ------------------
Base domain | *id.yourcompany.com*
Login       | **login**.*id.yourcompany.com*
Console     | **console**.*id.yourcompany.com*
API         | **api**.*id.yourcompany.com*

> **Note**
>
> Although only the login domain needs to be a subdomain of the base domain, we recommend choosing a base domain and defining the remaining
> domains as subdomains of it, as shown above.

> **Tip**
>
> Ideally, you should also have a valid SSL certificate that encompasses the four domains before starting the installation.
> However, you can install GrantID without HTTPS and configure it later.