# Installing on-premise

This guide describes how to deploy a ui-bakery on-prem via `install.sh` script.

{% hint style="danger" %}
The script installs docker and docker-compose, which may upgrade some dependencies under the hood. Please be advised that if you run this script on the OS used as a server for other applications, those applications may break due to that potential dependencies upgrade.
{% endhint %}

## Installation requirements

* OS Linux Ubuntu 18.04 and above
* 2 vCPUs, 4 GiB memory, 20GiB disk space
* Must have full rights to use "sudo"
* These domains are accessible from your network:
  * `https://cruibakeryonprem.westeurope.data.azurecr.io`
  * `https://cruibakeryonprem.centralus.data.azurecr.io`
  * `https://raw.githubusercontent.com`

## Installation steps

1. Run this command preferably from `/home` Linux directory to download, install and launch UI Bakery:

   ```bash
   curl -k -L -o install.sh https://raw.githubusercontent.com/uibakery/self-hosted/main/install.sh && bash ./install.sh
   ```
2. In the process, upon request, enter the **license key**, **hosting URL**, and **port**.

{% hint style="info" %}
You can obtain your on-premise license key from the UI Bakery Cloud portal: <https://cloud.uibakery.io/settings/on-premise-license>.&#x20;

For **Enterprise** plans, please contact the UI Bakery Support team to receive your license key.
{% endhint %}

3. Once the installation is completed, open the browser using the *URL* and *port* provided earlier. By default it is <http://localhost:3030/>.
4. By default, the login page will open where you will need to **sign up** first before creating your workspace and building apps.&#x20;

**NOTE**: If Docker of a version less than the required (minimum 20.10.11) is already installed on the server, and/or Docker Compose (minimum 1.29.2), the script will be stopped. You need to update the versions of components manually and run the script again.

### Deployment by instance

To deploy the self-hosted version to specific instances, follow these comprehensive guides:

* [Azure virtual machine](/on-premise/install-and-update/installing-on-premise-version/azure-virtual-machine.md)
* [Azure container instance](/on-premise/install-and-update/installing-on-premise-version/azure-container-instance.md)
* [AWS EC2 instance](/on-premise/install-and-update/installing-on-premise-version/aws-ec2-instance.md)
* [Google Cloud Compute Engine VM instance](/on-premise/install-and-update/installing-on-premise-version/google-cloud-compute-engine-vm-instance.md)
* [DigitalOcean 1-click droplet](/on-premise/install-and-update/installing-on-premise-version/digitalocean-1-click-droplet.md)
* [Manual w/ docker compose](/on-premise/install-and-update/installing-on-premise-version/manual-w-docker-compose.md)
* [Manual w/ docker run](/on-premise/install-and-update/installing-on-premise-version/manual-w-docker-run.md)
* [Windows installation](/on-premise/install-and-update/installing-on-premise-version/windows-installation.md)
* [Kubernetes](/on-premise/install-and-update/installing-on-premise-version/kubernetes.md)

## Additional recommended steps

UI Bakery installation is ready for production out of the box. However, there are additional setup [steps](/on-premise/install-and-update/recommendations/ui-bakery-in-production.md) we recommend following.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.