# 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](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/azure-virtual-machine)
* [Azure container instance](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/azure-container-instance)
* [AWS EC2 instance](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/aws-ec2-instance)
* [Google Cloud Compute Engine VM instance](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/google-cloud-compute-engine-vm-instance)
* [DigitalOcean 1-click droplet](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/digitalocean-1-click-droplet)
* [Manual w/ docker compose](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/manual-w-docker-compose)
* [Manual w/ docker run](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/manual-w-docker-run)
* [Windows installation](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/windows-installation)
* [Kubernetes](https://docs.uibakery.io/on-premise/install-and-update/installing-on-premise-version/kubernetes)

## Additional recommended steps

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