Dashboard Builder Free Download (Self-Hosted PHP)
Download the free trial of Dashboard Builder, the self-hosted PHP dashboard tool that connects to MySQL, MS SQL, PostgreSQL, Oracle and 25+ other data sources to build interactive dashboards without coding. It runs on Ubuntu and other Linux servers, on Windows and on macOS. The free trial never expires; it has a watermark and fewer features than the paid plans.
Requirements: PHP 8.2 or later, Apache or Nginx, Linux, Windows or macOS
MD5:
de6ae08419a2bcd9033de590d2c61a6bSHA-256:
c90f48efc89f3389dc8d87147a1e2863fcf5caac20fb19e79358ee5dac3cb0e1How to Download and Install
Choose your system. Every command box has a copy button on the right: click it and the whole box is copied to your clipboard, ready to paste into your terminal.
Jump to: Ubuntu / Linux | Windows | Git | Docker
1. Install on Ubuntu or Linux (Apache + PHP)
These steps are for Ubuntu and other Debian-based servers running Apache. On Ubuntu, Apache runs as the user www-data, so the app’s data and store folders must be writable by that user. Steps 3 and 4 take care of that, so you do not need to set permissions to 777.
Step 1: Install Apache, PHP and Composer
sudo apt update
sudo apt install -y apache2 php libapache2-mod-php php-xml php-sqlite3 php-mysql composer unzip git
php-xml provides SimpleXML, and php-sqlite3 and php-mysql provide the PDO drivers. Add php-pgsql if you use PostgreSQL.
Step 2: Download Dashboard Builder
sudo mkdir -p /var/www/html/dashboardbuilder
sudo chown $USER:$USER /var/www/html/dashboardbuilder
cd /var/www/html/dashboardbuilder
composer create-project --no-dev dashboardbuilder/dashboardbuilder.net .
This puts the app in /var/www/html/dashboardbuilder. Use another folder if you prefer, and change the path in the next steps to match.
Step 3: Let Apache write to the data and store folders
sudo chgrp -R www-data data store
sudo find data store -type d -exec chmod 775 {} +
sudo find data store -type f -exec chmod 664 {} +
sudo -u www-data touch data/_test && echo WRITE_OK && sudo rm data/_test
Run these from inside the app folder. WRITE_OK means Apache can write. If you get “Permission denied”, check every folder above the app with namei -l /var/www/html/dashboardbuilder/data: each one needs execute permission for others (for example drwxr-xr-x).
Step 4: Enable URL rewriting for the app
sudo a2enmod rewrite
sudo sed -i '/<Directory \/var\/www\/>/,/<\/Directory>/ s/AllowOverride None/AllowOverride All/' /etc/apache2/apache2.conf
sudo apache2ctl configtest
sudo systemctl restart apache2
Ubuntu’s default Apache setting ignores .htaccess files, and Dashboard Builder uses them to route its pages. Without this step the app shows Apache’s “404 Not Found”. The sed line changes AllowOverride None to AllowOverride All only inside the /var/www/ block. configtest should print Syntax OK.
Step 5: Open the app
Go to http://YOUR_SERVER_IP/dashboardbuilder in your browser (or http://localhost/dashboardbuilder on the same machine).
Not Ubuntu? On CentOS, Rocky Linux and Fedora the Apache user is apache, not www-data, and packages are installed with dnf. Everything else works the same way.
Something went wrong? See the answers below for the “folder is not writeable” error and the 404 Not Found error, or ask in the on-premises forum. To check what Apache is reporting, run sudo tail -n 60 /var/log/apache2/error.log.
2. Install on Windows (XAMPP or WAMP)
On Windows you run Dashboard Builder on a local web server such as XAMPP or WAMP, which include Apache and PHP. If you would rather not set up a server, the Windows desktop version installs from the Microsoft Store and needs no web server.
- Install XAMPP or WAMP, and install Composer for Windows from getcomposer.org so that
composeris in your PATH. - Open Command Prompt or PowerShell and go to your web root (for example
C:\xampp\htdocs\dashboardbuilder), then run:
composer create-project --no-dev dashboardbuilder/dashboardbuilder.net .
- Make sure the PHP extensions PDO and SimpleXML are enabled in
php.ini, and that thedata/andstore/folders are writable. - Start Apache (and MySQL if you use it) from the XAMPP control panel, then open
http://localhost/dashboardbuilder.
3. Install with Git (any system)
Requirements: Git installed (Git for Windows on Windows). The source is on GitHub.
git clone https://github.com/DashboardBuilder/dashboardbuilder.net.git
After cloning:
- Go into the folder and run
composer install(if composer.json is present). - Place the folder inside your web server root (for example
/var/www/htmlon Ubuntu, orC:\xampp\htdocson XAMPP) or point your virtual host at it. On Ubuntu, also follow steps 3 and 4 above. - Start your web server and open
http://localhost/dashboardbuilder(or your virtual host).
4. Install with Docker
Requirements: Docker (on Windows, Docker Desktop with the WSL2 backend is recommended).
docker pull dashboardbuilder/php-bi:latest
Run a container (simple example):
docker run -d -p 8080:80 --name dashboardbuilder dashboardbuilder/php-bi:latest
Recommended: use docker-compose when you need persistent volumes, database linking, or custom environment variables. Example docker-compose.yml (place it in a folder and run docker-compose up -d):
version: '3.7'
services:
php-bi:
image: dashboardbuilder/php-bi:latest
ports:
- "8080:80"
volumes:
- ./data:/var/www/html/data
restart: unless-stopped
The ./data line maps a local folder so your data persists. Windows tips: use an absolute Windows path for volumes (for example C:\mydata:/var/www/html/data) or use WSL2 to avoid slow bind mounts. If ports conflict, change the left side of the mapping (for example 8081:80).
Frequently Asked Questions (How-to)
- Install Apache, PHP (with php-xml and a database driver such as php-sqlite3 or php-mysql) and Composer with apt.
- Create the folder
/var/www/html/dashboardbuilder, make your user its owner, and runcomposer create-project --no-dev dashboardbuilder/dashboardbuilder.net .inside it. - Give the group
www-datawrite access to thedataandstorefolders (775 for folders, 664 for files). Do not use 777. - Enable
mod_rewriteand setAllowOverride Allfor/var/www/, then restart Apache. - Open
http://YOUR_SERVER_IP/dashboardbuilder. The full commands, with copy buttons, are in the Ubuntu / Linux section above.
On Ubuntu, Apache runs as the user www-data, not as the account that owns your files. If www-data is neither the owner nor in the owning group, it counts as “others” and cannot write to data. (WAMP and XAMPP on Windows run Apache as your own user, so this does not happen there.) Run sudo chgrp -R www-data data store inside the app folder, then set 775 on the folders and 664 on the files. Avoid chmod 777: it works because it lets everyone write, but any local user or process could then change your data files. If it still fails, run namei -l /var/www/html/dashboardbuilder/data and check that every folder in the path has execute permission for others.
Ubuntu’s default Apache configuration sets AllowOverride None for /var/www/, so Apache ignores .htaccess files. Dashboard Builder uses .htaccess rewrite rules to route its pages (for example app/qb), so without them every page returns 404. Enable the rewrite module with sudo a2enmod rewrite, change AllowOverride None to AllowOverride All in the <Directory /var/www/> block of /etc/apache2/apache2.conf, and restart Apache with sudo systemctl restart apache2. To see what Apache reports, run sudo tail -n 60 /var/log/apache2/error.log.
- Install a local web server: XAMPP or WAMP (includes PHP, Apache, MySQL).
- Install Composer for Windows (getcomposer.org).
- Open Command Prompt, navigate to your webroot (for example
C:\xampp\htdocs), and either clone the repo and runcomposer install, or runcomposer create-project --no-dev dashboardbuilder/dashboardbuilder.net . - Ensure required PHP extensions (PDO, SimpleXML) are enabled in php.ini.
- Set folder write permissions via Properties → Security for the web server user or give write access to the project folders that need it.
- Start Apache and MySQL from XAMPP control panel and visit
http://localhost/your-folder.
- Make sure PHP and Composer are installed and in PATH.
- Open terminal in your project folder or webroot.
- Run:
composer create-project --no-dev dashboardbuilder/dashboardbuilder.net . - After installation, configure database settings and any environment files required by the package.
- Install Git for Windows.
- Open Git Bash, run
git clone https://github.com/DashboardBuilder/dashboardbuilder.net.git. - Run
composer installinside the cloned folder (if necessary). - Move the folder to your web server root, start the server, and open the site in your browser.
- Install Docker Desktop and enable WSL2 on Windows for best performance.
- Use the example
docker-compose.ymlabove to map a local folder to/var/www/html/data. - Run
docker-compose up -d. Your data will persist in the mapped local folder.
- Composer install: run
composer update dashboardbuilder/dashboardbuilder.net. - Git clone: inside the repo run
git pull origin mainthen runcomposer installif dependencies changed. - Docker: pull the new image
docker pull dashboardbuilder/php-bi:latestand recreate the container.
Yes. The free trial never expires. It has fewer chart types and data sources than the paid plans and adds a watermark to output charts. For commercial use and the full feature set, see the self-hosted plans: Essential, Professional and Enterprise, each a one-time payment.
Yes. The Windows desktop version installs from the Microsoft Store on Windows 10 (version 1809 or later) and Windows 11, and does not need a web server.
No. There is no mobile app in the app stores. Dashboards you build are responsive and work in any mobile browser, and the cloud edition can be used from your phone.
By downloading Dashboard Builder, you agree to the terms of the license agreement.