Installing Self-Hosted DronaHQ

Now deploy an airtight self-hosted version of DronaHQ within your own infrastructure. Connect and access your secure data sources and build your apps and tools at blazing speed. You get a single-click installation. All your data stays within the system.

TL;DR DronaHQ self-Hosted installation steps are as below -

  • Create an account on the portal of Self-hosted DronaHQ website and log in to it.
  • You will receive a bash command.
  • Copy and paste the command into your system’s terminal.
  • This will download all the necessary files and libraries and thereafter will extract them.
  • Your self-hosted on-prem version of DronaHQ will start running on the localhost:8080.
  • Simply activate it and it will be ready to use.

Let’s host DronaHQ on-prem on your localhost

Hosting DronaHQ on-prem version is very easy. Simply go to Self-hosted DronaHQ website. Click on Get Started.

Follow the instructions and verify your account and complete the sign-up procedure.
Now login to your self-hosted portal with the credentials provided.

It will take you to the homepage. Where you can find your license to your self-hosted version along with instructions to self-host DronaHQ in your infrastructure. By default, you will be enabled on the free developer plan in which you can try everything, in the startup plan in creator mode. You can choose to upgrade to any of the plans in the billing section according to whatever is most suitable for you.

You will get a bash command to download our self-hosted deployment repo, which you can run on your local machine and will help with software installation*.* Currently, we only have Docker whereas Kubernetes/Helm Charts, AWS EC2,, and others are yet to come.

Setting up DronaHQ on-Prem on Ubuntu

Open up your Ubuntu system’s terminal. Copy the bash command of the self-hosted repo consisting of your own license key, from the website and paste it into the terminal, and hit enter.

NOTE: Self-hosted server needs to communicate with our license.dronahq.com server to perform license sync, so users need to enable communication with our server, essentially whitelisting the endpoint in the their firewall, if any.

The command will pull all the details from the repo and will also install missing items like docker, docker-compose, and more.

Once the extracting is done after pulling all the files, it will launch the localhost for your self-hosted DronaHQ on-prem version.

NOTE: After installing everything, it usually takes 3-5mins to open localhost. Users can put localhost:8080 in the search bar in case of delay.

An activation window will open where you need to give your details like user name, email ID, and password, to activate the self-hosted server. Make sure that the Email ID is the same as the email you have used while signup on the self-hosted portal.

Click on Activate now and you will be redirected to the homepage of your self-hosted DronaHQ on-prem version in your system’s localhost.

Since you are accessing the DronaHQ using an IP address, you will have to update the IP address in your .env file.

Open dronahq.env file in your Installation directory -

Locate this - BUILDER_URL= http://localhost:8080
Update it to - BUILDER_URL= http://your-ip-address:8080

Save and close the above file and finally restart the web app using the below command-
sudo docker-compose restart webapp

Single Deployments

  • 1.0.0 - Released on 14/4/2022`

Releases are added maintained on DockerHub and on DronaHQ Community

Machine Specs: Prerequisites

  • Linux Virtual Machine

    • Ubuntu 20.04 or higher
  • 2 vCPUs

  • 8 GiB + of Memory

  • 60 GiB + of Storage

  • Networking Requirements for Initial Setup:

    • 80 (http): for connecting to the server from the browser

    • 443 (https): for connecting to the server from the browser

    • 22 (SSH): To allow you to SSH into your instance and configure it

    • 8080 (DronaHQ): This is the default port DronaHQ runs on

Deploy on Linux

  1. Run the command git clone https://github.com/dronahq/self-hosted.git.

  2. Run the command cd self-hosted to enter the cloned repository’s directory.

  3. Edit the docker-compose.yml file using VIM (or other text editor) to set the version of DronaHQ you want to install. To do this, replace X.Y.Z in image:dronahq/self-hosted:X.Y.Z with your desired version. See Select a DronaHQ version number to help you choose a version.

  4. Run ./install.sh to install Docker and Docker Compose.

  5. In your .env (this file is only created after running ./install.sh) add the following:

    # License key granted to you by DronaHQ
    LICENSE_KEY=YOUR_LICENSE_KEYs

  6. Run sudo docker-compose up -d to start the DronaHQ server.

  7. Run sudo docker-compose ps to make sure all the containers are up and running.

  8. Navigate to your server’s IP address in a web browser. DronaHQ should now be running on port 8080.

  9. Click Activate, since we’re starting from a clean slate. The first user to create an account on an instance becomes the administrator.

AWS Deploy with EC2

  1. Spin up a new EC2 instance. If using AWS, use the following steps:

  2. On AWS EC2 dashboard, Click Launch Instance.

  3. Click Select for an Ubuntu instance with version 20.04 or higher.

  4. Select an instance type of at least t3.medium and click Next.

  5. Ensure you select the same VPC that also includes the Databases & API’s that you will want to connect to and click Next.

  6. Increase the storage size to 60 GB or higher and click Next.

  7. Optionally add some Tags (e.g. app = dronahq) and click Next. This makes it easier to find if you have a lot of instances.

  8. Set the network security groups for ports 80, 443, 22 and 8080, with sources set to 0.0.0.0/0 and ::/0, and click Review and Launch. We need to open ports 80 (http) and 443 (https) so you can connect to the server from a browser, as well as port 22 (ssh) so that you can ssh into the instance to configure it and run DronaHQ. By default on a vanilla EC2, DronaHQ will run on port 8080.

  9. On the Review Instance Launch screen, click Launch to start your instance.

  10. If you’re connecting to internal databases, whitelist the VPS’s IP address in your database.

  11. From your command-line tool, SSH into your EC2 instance.

  12. Run the command git clone https://github.com/dronahq/self-hosted.git.

  13. Run the command cd self-hosted to enter the cloned repository’s directory.

  14. Edit the docker-compose.yml file using VIM (or other text editor) to set the version of DronaHQ you want to install. To do this, replace X.Y.Z in image:dronahq/self-hosted:X.Y.Z with your desired version. See Select a DronaHQ version number to help you choose a version.

  15. Run ./install.sh to install Docker and Docker Compose.

  16. In your .env (this file is only created after running ./install.sh) add the following:

    # License key granted to you by DronaHQ
    LICENSE_KEY=YOUR_LICENSE_KEYs

  17. Run sudo docker-compose up -d to start the DronaHQ server.

  18. Run sudo docker-compose ps to make sure all the containers are up and running.

  19. Navigate to your server’s IP address in a web browser. DronaHQ should now be running on port 8080.

  20. Click Activate, since we’re starting from a clean slate. The first user to create an account on an instance becomes the administrator.

GCP Deploy with Compute Engine Virtual Machine

  1. On GCP Dashboard, Click the Compute Engine Resource and select VM Instances

  2. select ‘Create Instance’ from the top menu

  3. Create a new VM to these Specs

    • Ubuntu Operating System Version 20.04 LTS or higher

    • Storage Size 60 GB or higher

    • Ram 4 GB or Higher (e2-medium)

    • Optionally add Labels (eg app = dronahq)

  4. Create Instance

  5. Navigate via search to the VPC Network Firewall settings and be sure to add the following ports set to0.0.0.0/0 and ::/0

    • 80 (HTTP)
      1. 443 (HTTPS)
      1. 22 (SSH)
    • 8080 (DronaHQ access in browser)
  6. If you’re connecting to an internal database, be sure to whitelist the VPC’s ip address in your DB

  7. SSH into your instance, or use the Google SSH Button to open a VM Terminal in a browser window.

  8. Run Command git clone https://github.com/dronahq/self-hosted.git

  9. Run Command cd self-hosted

  10. Edit the Docker-Compose file using VIM (or other text editor) to specify your desired version number of DronaHQ. To do this, replace X.Y.Z in image:dronahq/self-hosted:X.Y.Z with your desired version. See Select a DronaHQ version number to help you choose a version.

  11. Run the command git clone https://github.com/dronahq/self-hosted.git.

  12. Run the command cd self-hosted to enter the cloned repository’s directory.

  13. Edit the docker-compose.yml file using VIM (or other text editor) to set the version of DronaHQ you want to install. To do this, replace X.Y.Z in image:dronahq/self-hosted:X.Y.Z with your desired version. See Select a DronaHQ version number to help you choose a version.

  14. Run ./install.sh to install Docker and Docker Compose.

  15. In your .env (this file is only created after running ./install.sh) add the following:

    # License key granted to you by DronaHQ
    LICENSE_KEY=YOUR_LICENSE_KEYs

  16. Run sudo docker-compose up -d to start the DronaHQ server.

  17. Run sudo docker-compose ps to make sure all the containers are up and running.

  18. Navigate to your server’s IP address in a web browser. DronaHQ should now be running on port 8080.

  19. Click Activate, since we’re starting from a clean slate. The first user to create an account on an instance becomes the administrator.

Azure Deploy with Azure Virtual Machine

  1. In the main Azure Portal, select Virtual Machine under Azure Services

  2. Click the Create button and select Virtual Machine

  3. Select an image of Ubuntu 20.04 or higher

  4. For instance size, select Standard_D2s_v3 - 2 vcpus, 8 GiB memory

  5. Under the Networking tab, Ensure you select the same Virtual Network that also includes the Databases / API’s you will want to connect to and click Next.

  6. Under the Networking tab, configure your network security group to contain the following ports. You may need to create a new Security group that contains these 4 ports (80, 443, 22 and 8080):

    • 80 (http) and 443 (https) for connecting to the server from a browser

    • 22 (ssh) to allow you to ssh into the instance and configure it

    • 8080 is the port that DronaHQ runs on by default

  7. From your command line tool, SSH into your Azure instance.

  8. Run the command git clone https://github.com/dronahq/self-hosted.git.

  9. Run the command cd self-hosted to enter the cloned repository’s directory.

  10. Edit the docker-compose.yml file using VIM (or other text editor) to set the version of DronaHQ you want to install. To do this, replace X.Y.Z in image:dronahq/self-hosted:X.Y.Z with your desired version. See Select a DronaHQ version number to help you choose a version.

  11. Run ./install.sh to install Docker and Docker Compose.

  12. In your .env (this file is only created after running ./install.sh) add the following:

    # License key granted to you by DronaHQ
    LICENSE_KEY=YOUR_LICENSE_KEYs

  13. Run sudo docker-compose up -d to start the DronaHQ server.

  14. Run sudo docker-compose ps to make sure all the containers are up and running.

  15. Navigate to your server’s IP address in a web browser. DronaHQ should now be running on port 8080.

  16. Click Activate, since we're starting from a clean slate. The first user to create an account on an instance becomes the administrator.