Mac OS/Windows

For Windows and MacOS Users

If you are on Windows or MacOS start with the instructions below. Once these steps are completed, proceed to the General Prerequisites section.

1. Docker Desktop Installation: Download and install Docker Desktop from Docker's official website. Docker Desktop provides the necessary environment for running containerized applications on MacOS and Windows.
2. Enable Kubernetes: Open Docker Desktop. Navigate to the Preferences or Settings menu. Locate the Kubernetes section and select the Enable Kubernetes checkbox.

General Prerequisites

1. Install node v14.18.2: You can find installation instructions specific to your operating system on the NVM's github page. Generally, the following command should work for most environments:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash \
      && source ~/.bashrc \
      && nvm install v14.18.2
   

2. Verify that the install/current version of node on your machine is 14.18.2 by running the following command:

   node -v 
   

3. Install K3S: Skip this step if you installed Docker Desktop.

   curl -sfL https://get.k3s.io | sh - \
     && mkdir ~/.kube \
     && echo "export KUBECONFIG=~/.kube/config" >> ~/.bashrc \
     && source ~/.bashrc \
     && sudo k3s kubectl config view --raw > "$KUBECONFIG"
     && kubectl get nodes
   

4. Verify kubectl: Make sure that you have access to kubectl. Execute the following command to confirm:

   kubectl get nodes
   

   You should receive a response similar to the following, indicating a successful Kubernetes setup:

   username@machinename:~/pro-manager$ kubectl get nodes
   NAME             STATUS   ROLES                  AGE   VERSION
   machinename      Ready    control-plane,master   19h   v1.24.3+k3s1 
   

5. Install ingress: See the Quick Start guide or use the command below.

   kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.5.1/deploy/static/provider/cloud/deploy.yaml
   

6. Install cert-manager.

   kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.12.0/cert-manager.yaml
   

7. Access the Backendless Pro Manager

   With the public IP or URL:

   1. Open a web browser.
   2. Navigate to http://<your-public-ip>:5050. Replace <your-public-ip> with the actual public IP address of your instance.

   This URL will direct you to the Backendless PRO Manager.

8. Install Backendless PRO

   Upon accessing the Backendless PRO Manager, you will be presented with a setup form. Complete the form to start the installation process of Backendless PRO. This setup will configure Backendless PRO to operate with your instance specifics.

   Once the installation is completed, you will be able to use Backendless PRO on the instance. For further operations or troubleshooting, refer to the specific sections of the Backendless documentation or contact support if you encounter issues beyond the setup scope.