On certain occasions, you might not be able to install applications automatically. Whether your hosting provider does not support an automatic installer, such as Softaculous Auto Installer, or you simply prefer to stick to the old-fashioned method.
We are going to step-by-step guide you on how to install the Una software manually. At the end of this tutorial, you will not only have a website empowered by Una, but you will know the fundamentals of installing web applications manually.
Your very first step is to download the required installation files from the official Una website. At the time of writing this tutorial, Una offers free and commercial licenses. Depending on the case, you have to click either on the "Download" button or proceed with the purchase of the software license.
Please note that to download the installation files, you are required to create an account or log in to your existing one. Once this is fulfilled, you are allowed to initiate the download process.
When initiated, it is going to take a few moments to be completed, so please allow it the necessary time.
Now it is time to upload the installation files to your web hosting account. There are two methods you can follow to complete this task, and they are both relatively straightforward.
Regardless of which method you find more convenient and decide to follow, you need to pay close attention to the directory under which you are located while you are uploading/extracting the files as this determines the directory under which Una is going to be installed.
If you want Una to be installed directly onto your domain name (i.e., yourdomain.com), make sure to upload the files to the root folder (Usually, this is the public_html directory). Alternatively, if you wish Una to be installed in a subdirectory (e.g., yourdomain.com/social), you need to create the subfolder and upload/extract the files under it.
There is another critical thing to mention. Once you extract the archive, you end up with a new folder called "UNA-v.XX.X.X" under which the actual installation files are located. It is vital to move all the data from this folder directly under the directory under which the installation should take place. If this is NOT done, you end up with a web address such as yourdomain.com/UNA-v.XX.X.X, and we firmly believe this is not something you want.
Now that we got it all clear, let's review each of the methods, and you can decide which one to follow.
The first method is to directly upload and extract the archive file using the "File Manager" tool integrated into your cPanel account. You can find step-by-step instructions on how to upload and extract files in our guide based on How to manage the files of your hosting account using the File Manager feature. For your convenience, we include direct links to each of the sections:
The second method is to extract the archive file on your local computer and upload the files to your web hosting account using your favorite FTP Client. In our tutorials based on FTP Services, you can find detailed instructions on how to upload files using various FTP Clients.
Una requires a database to function properly and store your website data. Therefore, you need to create a fresh, new one to be assigned to the software during the installation process. That can be done within a few clicks via the "MySQL Database Wizard" tool integrated into your cPanel account. You can find step-by-step instructions in our guide on How to create MySQL Database via cPanel.
While you are creating the database, please make sure to keep the database name, username, and password on file as you are doing to need them later on while setting up the application.
Once your new database is created, you are ready to step into setting up Una.
Now that you have completed all the required steps, you are finally ready to install Una. Please open your favorite web browser and enter the URL address of your website. This action automatically launches the Installer.
In the first step, you have to select the desired installation language and click on the "Start installation" button. By clicking on the "Server audit" button, you can initiate a system check to confirm your web hosting environment meets the application requirements.
In the second step, a check is performed to confirm the files and folder are set with the correct permissions. If incorrect permissions are detected, they are highlighted in red under the "Current status" column. In such a case, you have to edit the permissions and set them to the required value. You can do that within your FTP Client or the "File Manager" tool. In case you need further instructions, please refer to our tutorials pointed in the "Uploading Installation Files" section.
In the following screenshot example, you can see the "plugins/ffmpeg/ffmpeg.exe" file is not executable. Therefore, we need to set its permission to "755".
When you perform the required change, please go back to the Installation screen and click on the "Refresh" button.
Once you confirm all files and folders have the correct permissions, please click on the "Continue" button.
Last is the "Site configuration" step. It is split into a few sections where you have to define your site and database details.
Generally, you do not have to perform any changes on the "Site Paths" section unless strictly required by your hosting provider. We recommend you to leave the default values.
Under the "DB Config" section, please enter your database name, database username, and database password into the corresponding fields. Leave the rest of the fields as they are unless otherways required.
Under the "Site Info" section, you have to define the following details:
Under the "Link with Una Market", you can define the key and secret required for software version update checks. You can obtain them from the "Keys & Secrets" section in your UNA account. They are not mandatory, so you can proceed without them.
Under the "Modules" section, you have to select the desired application language, website template, and profiles module.
Once you are ready, please click on the "Submit" button to initiate the installation. Please allow it with a few moments to be completed. When it is done, you are prompted with a message confirming it went successfully.
At this point, Una is successfully installed on your domain name. There is one last and fundamentally important step you need to take. You have to delete the "installation" folder as it might interfere with your website security. This folder is located under the root directory of the Una installation.
When this is done, you are ready to explore your Una backend by going to "yourdomain.com/studio".
We would like to congratulate you on successfully installing Una on your brand new website. We hope our instructions were clear and easy to follow. In case you have experienced any difficulties with the installation, please make sure to contact our Technical Support Team by submitting a ticket request from your HostArmada Client Dashboard. They will gladly handle the installation for you.
Sebahat is a young and bright person who had become an invaluable part of our team. Started as a Customer Care Representative who quickly evolved into a Tech-savvy well familiar with every support layer of the company. Driven by the aim to constantly improve our customers’ experience she is committed to enhancing the extraordinary support we deliver.