# Self-Hosted Deployment

> Learn how to deploy and manage Self-Hosted Deployment in your private cloud.

# Self-Hosted Deployment

- [Self-Hosted Deployment](https://docs.unity.com/en-us/self-hosted-deployment.md): Learn how to deploy and manage Self-Hosted Deployment in your private cloud.
- [Overview](https://docs.unity.com/en-us/self-hosted-deployment.md): Learn how to deploy and manage Self-Hosted Deployment in your private cloud.

## Amazon Web Services

- [Amazon Web Services](https://docs.unity.com/en-us/self-hosted-deployment/aws.md): Deploy and manage your private cloud
- [Release notes](https://docs.unity.com/en-us/self-hosted-deployment/aws/release-notes.md): Learn about new features, improvements, and fixed issues.

### Installation

- [Installation](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation.md): Install Self-Hosted Deployment in Amazon Web Services for the first time
- [Infrastructure overview](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/infrastructure.md): Learn which resources the deployment creates and how to securely expose them through the external load balancer
- [Prerequisites](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/prerequisites.md): Before you deploy Self-Hosted Deployment to Amazon Web Services
- [Deployment](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/deployment.md): Deploy Self-Hosted Deployment to Amazon Web Services

#### Postdeployment

- [Postdeployment](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/postdeployment.md): Complete the setup of Self-Hosted Deployment before running it in production
- [Set up the identity subsystem](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/set-up-identity-subsystem.md): Set up the identity subsystem, based on Keycloak
- [Set up backups for Percona Server for MongoDB](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/set-up-psmdb.md): Set up backups for your database infrastructure in your own Kubernetes cluster
- [Set up Percona Monitoring and Management](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/set-up-pmm.md): Set up the monitoring of your database infrastructure
- [Migrate data to Percona Server for MongoDB](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/migrate-to-psmdb.md): If you use Percona Server for MongoDB, migrate your data to it from the MongoDB virtual machine in your Kubernetes cluster
- [Security](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/security.md): Enforce security for Self-Hosted Deployment in Amazon Web Services
- [Costs](https://docs.unity.com/en-us/self-hosted-deployment/aws/installation/costs.md): Estimate how much Amazon charges for the services that you run in Self-Hosted Deployment

### Maintenance

- [Maintenance](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance.md): Increase scalability and service quotas, rotate secrets, perform health checks, restore databases, perform upgrades
- [Autoscaling of pods](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/pod-autoscaling.md): Increase the scalability of the system
- [Backup and recovery](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/backup-and-recovery.md): In the case of an emergency, restore your databases
- [Test and troubleshoot your solution](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/test-and-troubleshoot.md): Diagnose and resolve issues with your deployment
- [Health checks](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/health-checks.md): Ensure that the state of services within Kubernetes is healthy
- [Rotate secrets](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/rotate-secrets.md): Regenerate the secrets in Amazon Web Services Secrets Manager
- [Upgrade](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/upgrade.md): Install a more recent package, apply the required changes in configuration, and upgrade the helm charts
- [Migrate Mini-USF to v2](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/migrate-mini-usf-to-v2.md): Learn how to migrate Mini-USF, due to architectural changes that decouple Keycloak from entities such as projects.
- [Service limits](https://docs.unity.com/en-us/self-hosted-deployment/aws/maintenance/service-limits.md): Increase the quotas of services whose limits you have reached

## Microsoft Azure

- [Microsoft Azure](https://docs.unity.com/en-us/self-hosted-deployment/azure.md): Deploy and manage your private cloud

### Installation

- [Installation](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation.md): Install Self-Hosted Deployment in Microsoft Azure for the first time
- [Deployment modes](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/deployment-modes.md): Understand the differences between deployment modes

#### Deployment through Azure Marketplace

- [Deployment through Azure Marketplace](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/marketplace.md): Install Self-Hosted Deployment to Microsoft Azure through Azure Marketplace for the first time
- [Infrastructure overview](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/infrastructure.md): Learn which resources deployment creates and which endpoints it exposes
- [Prerequisites](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/prerequisites.md): Before you deploy Self-Hosted Deployment to Microsoft Azure
- [Deployment](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/deployment.md): Deploy Self-Hosted Deployment through Azure Marketplace

##### Postdeployment

- [Postdeployment](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/postdeployment.md): Complete the setup of Self-Hosted Deployment before running it in production
- [Set up network integration](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/set-up-network-integration.md): Set up network integration with the customer environment
- [Set up the identity subsystem](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/set-up-identity-subsystem.md): Set up the identity subsystem, based on Keycloak
- [Monitor integration](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/monitor-integration.md): Set alert rules
- [Firewall rules for the outbound internet access](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/firewall-rules-for-outbound-internet-access.md): If you want to restrict outbound access, configure the required firewall rules
- [Manual deployment](https://docs.unity.com/en-us/self-hosted-deployment/azure/installation/bespoke.md): Deploy Self-Hosted Deployment to Microsoft Azure manually

### Maintenance

- [Maintenance](https://docs.unity.com/en-us/self-hosted-deployment/azure/maintenance.md): Upgrade your solution, restore databases
- [Solution monitoring](https://docs.unity.com/en-us/self-hosted-deployment/azure/maintenance/monitor-solution.md): Access the logs and metrics

## On premises

- [On premises](https://docs.unity.com/en-us/self-hosted-deployment/on-premises.md): Deploy Unity Asset Manager in your own datacenter or colocation facility.
- [Release notes](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/release-notes.md): Learn about new features, improvements, and changes in each release of Self-Hosted Deployment On-Premises

### Installation

- [Installation](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation.md): Install Self-Hosted Deployment on-premises for the first time
- [Infrastructure overview](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/infrastructure.md): Learn about the infrastructure requirements for an on-premises deployment of Self-Hosted Deployment
- [Hardware requirements](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/hardware-requirements.md): Plan the physical infrastructure for a baseline production on-premises deployment
- [Prerequisites](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/prerequisites.md): Before you deploy Self-Hosted Deployment on premises
- [Deployment](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/deployment.md): Deploy Self-Hosted Deployment on premises using the vpctl tool

#### Postdeployment

- [Postdeployment](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/postdeployment.md): Complete the setup of Self-Hosted Deployment before running it in production
- [Set up the identity subsystem](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/set-up-identity-subsystem.md): Set up the identity subsystem, based on Keycloak
- [Costs](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/installation/costs.md): Estimate the hardware investment and recurring operating cost categories for an on-premises deployment

### Maintenance

- [Maintenance](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/maintenance.md): Upgrade, perform health checks, and troubleshoot your on-premises deployment
- [Upgrade](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/maintenance/upgrade.md): Pull a more recent release, sync updated images, and redeploy using the vpctl tool
- [Health checks](https://docs.unity.com/en-us/self-hosted-deployment/on-premises/maintenance/health-checks.md): Run health checks on your on-premises deployment

## Administration

- [Administration](https://docs.unity.com/en-us/self-hosted-deployment/admin.md): Manage your organization, identity, and projects in your private cloud
- [Access the Keycloak admin console](https://docs.unity.com/en-us/self-hosted-deployment/admin/keycloak-admin-console.md): Manage identity in Self-Hosted Deployment from Keycloak
- [Complete initial solution onboarding](https://docs.unity.com/en-us/self-hosted-deployment/admin/solution-onboarding.md): Finalize configuration of the organization and the first user

### Single sign-on

- [Single sign-on](https://docs.unity.com/en-us/self-hosted-deployment/admin/single-sign-on.md): Set up single sign-on with OpenID Connect for your private cloud
- [Integrate with the identity service provider](https://docs.unity.com/en-us/self-hosted-deployment/admin/single-sign-on/integrate-with-idp.md): Set up integration so that Keycloak delegates authentication to an external enterprise identity provider
- [Configure the user experience for SSO](https://docs.unity.com/en-us/self-hosted-deployment/admin/single-sign-on/configure-user-experience.md): Set SSO as the only sign-in experience for local users
- [Rotate the client secret for the SSO application](https://docs.unity.com/en-us/self-hosted-deployment/admin/single-sign-on/rotate-client-secret.md): Minimize the risk of unauthorized access or misuse of secrets

### Organizations and projects

- [Organizations and projects](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects.md): Set up and update your organization and projects
- [Create a project](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects/create-project.md): Create a new project to organize your assets
- [Rename a project](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects/rename-project.md): If you want a project to have a different name
- [Archive a project](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects/archive-project.md): Make a project inactive and prevent users from accessing it
- [Unarchive a project](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects/unarchive-project.md): Make a previously archived project active again
- [Delete a project](https://docs.unity.com/en-us/self-hosted-deployment/admin/organizations-projects/delete-project.md): Erase a project with no recovery option

### Users and service accounts

- [Users and service accounts](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts.md): Manage users, service accounts, and access in your private cloud
- [Create a user](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/create-user.md): Manually create users if you work in local-only mode or without SSO-only configuration
- [Manage access for a user](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/manage-access-for-user.md): Choose a set of permissions for each user
- [Create a service account](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/create-service-account.md): Create service accounts for programmatic access to Unity services
- [Manage access for a service account](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/manage-access-for-service-account.md): Choose a set of permissions for each service account
- [Manage keys for a service account](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/manage-keys-for-service-account.md): Create or delete service account credentials
- [Authenticate with a service account](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/authenticate-with-service-account.md): Use Basic or Bearer authentication when accessing APIs with a service account
- [Delete a service account](https://docs.unity.com/en-us/self-hosted-deployment/admin/users-service-accounts/delete-service-account.md): Completely remove a service account

### Groups

- [Groups](https://docs.unity.com/en-us/self-hosted-deployment/admin/groups.md): Leverage groups to control user access in bulk.
- [Manage groups](https://docs.unity.com/en-us/self-hosted-deployment/admin/groups/group-management.md): Create, update, delete groups, and manage their membership.
- [Grant and revoke access from groups](https://docs.unity.com/en-us/self-hosted-deployment/admin/groups/group-based-access.md): Manage access to projects using groups.

### Licensing

- [Licensing](https://docs.unity.com/en-us/self-hosted-deployment/admin/licensing.md): Configure and access Licensing Server in Self-Hosted Deployment, and manage users and licenses.
- [Configure and access Licensing Server](https://docs.unity.com/en-us/self-hosted-deployment/admin/licensing/configure-access-licensing-server.md): Grant access to Licensing Server and access its dashboard.
- [Install licenses](https://docs.unity.com/en-us/self-hosted-deployment/admin/licensing/install-licenses.md): Request, import, and verify licenses in Licensing Server before assigning seats to users.
- [Manage users and seats](https://docs.unity.com/en-us/self-hosted-deployment/admin/licensing/manage-users-seats.md): Import users and manage seat assignments.

### upc-cli tool

- [upc-cli tool](https://docs.unity.com/en-us/self-hosted-deployment/admin/upc-cli.md): Perform global administration and bulk access management tasks.
- [Running the upc-cli tool](https://docs.unity.com/en-us/self-hosted-deployment/admin/upc-cli/run-upc-cli.md): Prepare your environment and run upc-cli.

#### Usage scenarios

- [Usage scenarios](https://docs.unity.com/en-us/self-hosted-deployment/admin/upc-cli/upc-cli-scenarios.md): Apply the tool to common scenarios.
- [Manage organization feature flags](https://docs.unity.com/en-us/self-hosted-deployment/admin/upc-cli/upc-cli-scenarios/upc-cli-feature-flags.md): Add, update, or delete feature flags for an organization.
- [Perform bulk user access management](https://docs.unity.com/en-us/self-hosted-deployment/admin/upc-cli/upc-cli-scenarios/upc-cli-bulk-rbac.md): Grant or revoke access for multiple users at once.

### Custom branding

- [Custom branding](https://docs.unity.com/en-us/self-hosted-deployment/admin/custom-branding.md): Customize Unity Dashboard with your organization’s branding.
- [Enable custom branding](https://docs.unity.com/en-us/self-hosted-deployment/admin/custom-branding/enable-custom-branding.md): Configure Unity Dashboard to use your company logo and color palette.
- [Custom branding reference](https://docs.unity.com/en-us/self-hosted-deployment/admin/custom-branding/custom-branding-reference.md): Change Unity Dashboard appearance with custom branding options.
- [Security](https://docs.unity.com/en-us/self-hosted-deployment/security-overview.md): Security white paper for the deployment of Unity Asset Manager in a private cloud

## vpctl

- [vpctl](https://docs.unity.com/en-us/self-hosted-deployment/vpctl.md): Manage Self-Hosted Deployment releases on customer-operated Kubernetes clusters with vpctl command-line tool.
- [vpctl Architecture](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/architecture.md): Learn about vpctl trust boundaries, three usage modes, and what vpctl touches on the network and in your cluster.
- [Installation](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/install.md): Install the vpctl command-line tool, configure registry credentials, and review external CLI requirements.
- [Manifest reference](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/manifest.md): Reference for manifest.yaml, including the schema, initialization and validation commands, and an annotated example.

### vpctl commands

- [vpctl commands](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands.md): Reference documentation for vpctl commands, flags, workflows, and deployment operations
- [Artifact](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands/artifact.md): Mirror Docker images, ORAS artifacts, and OCI Helm charts between registries.
- [Configure](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands/configure.md): Manage registry credentials for vpctl.
- [Manifest](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands/manifest.md): Initialize, validate, and inspect the vpctl manifest schema
- [Release](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands/release.md): Pull, generate, deploy, and uninstall vpctl release commands
- [Secret](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/commands/secret.md): Generate and deploy Kubernetes Secret manifests from a secrets.import.yaml input
- [Troubleshooting](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/troubleshooting.md): Common vpctl errors and resolutions
- [Changelog](https://docs.unity.com/en-us/self-hosted-deployment/vpctl/changelog.md): The vpctl command-line tool release history, including new features, fixes, and breaking changes.