---
title: "Linux Installation | DreamFactory Docs"
source: "https://docs.dreamfactory.com/getting-started/installing-dreamfactory/linux-installation"
canonical_url: "https://docs.dreamfactory.com/getting-started/installing-dreamfactory/linux-installation"
converted_at: "2025-12-27T16:37:40.320Z"
format: "markdown"
converted_by: "html-to-md-ai"
---
DreamFactory can be installed on most common Linux platforms using our automated installer. The installer is designed to deploy DreamFactory as the primary application on the server (the site is published on port 80 of the local host).  This guide provides instructions for downloading and running the installer on a new Linux server.

## Supported operating Systems[​](#supported-operating-systems)

DreamFactory currently supports the following flavors of Linux:

- CentOS 7

- RHEL 7/8/9

- Oracle Linux 7/8

- Debian 10/11

- Fedora 36/37

- Ubuntu 22/24

## Automated installer[​](#automated-installer)

The installer can be found in [DreamFactory's GitHub repository](https://github.com/dreamfactorysoftware/dreamfactory/tree/master/installers).

Follow these steps to execute the script on your Linux machine:

1. Download the script from GitHub:

`wget https://github.com/dreamfactorysoftware/dreamfactory/raw/master/installers/dfsetup.run`

2. Make the installer executable:

`chmod +x dfsetup.run`

3. Run the installer as sudo:

`sudo ./dfsetup.run`

### Using the installer[​](#using-the-installer)

Once the installer opens, an interactive menu displays:

![linux installer start](/assets/images/df-linux-installer-start-31b47849e7a95b679735d9128d8f7964.png)

A typical installation uses options 0, 5, and 8 for a default build of the latest version of DreamFactory with NGINX as a web server. MariaDB is installed and configured as the system database, and a debug log is available in the `/tmp/` directory.

If using the options for Oracle or Trino drivers please refer to [Installing Additional Drivers](/getting-started/installing-dreamfactory/installing-additional-drivers)

The installer verifies the Linux platform is supported and then begins installing dependencies. As each dependency is installed, a progress bar (...) is visible along with any issues that are encountered. You can also tail the log file in the `/tmp` directory if needed.

![linux installer installing](/assets/images/df-linux-installer-installing-b012a4eaf40464151b2acfe735bd70e0.png)

The rest of the installer's process provides prompts for you to enter the location of commercial license files, database settings, and initial admin user information. Ensure that you record the system DB details before closing the terminal.

![linux installer complete](/assets/images/df-linux-installer-complete-419e586047905ea037c76ef3c056e9b6.png)

You can now access the DreamFactory UI from a web browser by pointing to the server IP address and using the credentials created during the installer process.

![DreamFactory login page](/assets/images/df-login-page-14ebb8d074dabb0cef29857998193c7a.png)

## About The system database[​](#about-the-system-database)

During the installation, you must point DreamFactory's installation to a system database. This database holds the entire configuration for your DreamFactory instance and can be used to replicate, restore, or upgrade an instance in the future. While the default configuration above can set up a system database on localhost, many users, especially those at scale, prefer the system database to be hosted elsewhere. This configuration can be (re)entered by running the following command from the `/opt/dreamfactory/` directory:

`php artisan df:env`

The configuration can also be changed manually by editing `/opt/dreamfactory/.env`. For more information, refer to our [DreamFactory Basic Configuration](/getting-started/dreamfactory-configuration/basic-configuration) documentation.

### Supported system databases[​](#supported-system-databases)

Currently, the supported system database types are:

- SQLite

- MySQL (MariaDB)

- PostgreSQL

- SQL Server