Installation guide for cPanel
This is a guide for installing FileRun on a hosting service which uses cPanel. It applies to most hosting services, as they all have similar control panel options.
1. Open cPanel
Login to the control panel of your hosting account.
2. Upload FileRun to your hosting
- Download the FileRun installation package from your FileRun client account: https://my.filerun.com/client-area-orders
- Open the hosting control panel, scroll down to the
Filessection and clickFile Manager - "File Manager" will open, browse the
public_htmlfolder and select your domain. - Create a new folder and browse into it.
- Click
Uploadand upload the FileRun installation package, the Zip file. - Get back to the folder listing and click
Reload, the uploaded file should appear. - Right-click the uploaded Zip file and select
Extractthen click theExtractbutton. Make sure you are extracting the archive in an empty folder, as existing files might get overwritten by this process. - Close the
Extraction Resultswindow.
3. Open FileRun web installer
When you open a browser window and direct it to the folder where you have extracted the file, you should see a page welcoming you to the FileRun installation wizard. If you don't, you should check that you have opened the right web address. If you are sure you have the right address, please check this page for troubleshooting: FileRun_Install_Guide#Troubleshooting
4. Create a MySQL Database
- Get back to the hosting control panel.
- Scroll to the
Databasessection and clickMySQL Databases. - In the
Create New Databasesection, fill in theNew Database:field. This field is usually prefixed with your hosting control panel username and the underscore character. - Type
fileror whatever name you wish to give to the database and clickCreate Databasebutton. - A confirmation page will be displayed letting you know that your
database has been created. Copy the database name to a text file on
your computer and click
Go Back.
5. Create a MySQL User
- In the
Add New Usersection, type in a username and a password. This user will be used by FileRun to connect to the MySQL database. You can use the provided password generator link to quickly get a secure password for the user. - Copy the username (including its account prefix) and the password to the text file where you have previously copied the database name.
- Click
Create User. A confirmation page will open letting you know that the new MySQL user have been added. Click 'Go Back'.
6. Add MySQL User to Database
- In the
Add User To Databasesection, select the recently created user and the database and click theAddbutton. A page will open, asking you to select the privileges for the user. - The simplest way is to select the big
ALL PRIVILEGESbutton and clickMake Changes. Again, clickGo Backin the confirmation page. - The MySQL configuration is now completed.
7. Complete FileRun setup
- Open the FileRun web-based installer and click
Next. TheSystem Requirements Testingpage will open displaying a list of requirements. On theNotescolumn, FileRun will tell you if the server meets the requirements or not. If theNextbutton is disabled, it means that you need to change something in the PHP configuration. If it's not, click "Next" to set theMySQL configurationinformation. - Fill in the form using the MySQL information you have previously
saved in the text file on your computer. On most servers, the
MySQL Serverfiled should be filled withlocalhost. - Click
Next. FileRun should let now let you know that the installation was completed successfully. Make note of the created access credentials and clickNextto open the FileRun login form.
8. Configure cronjobs
See this page.