# Installation

# Server Requirements

Before you install Flarum, it's important to check that your server meets the requirements. To run Flarum, you will need:

• Apache (with mod_rewrite enabled) or Nginx
• PHP 7.1+ with the following extensions: dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer
• MySQL 5.6+ or MariaDB 10.0.5+
• SSH (command-line) access to run Composer

# Installing

Flarum uses Composer to manage its dependencies and extensions. Before installing Flarum, you will need to install Composer on your machine. Afterwards, run this command in an empty location that you want Flarum to be installed in:

composer create-project flarum/flarum . --stability=beta

While this command is running, you can configure your web server. You will need to make sure your webroot is set to /path/to/your/forum/public, and set up URL Rewriting as per the instructions below.

When everything is ready, navigate to your forum in a web browser and follow the instructions to complete the installation.

# URL Rewriting

# Apache

Flarum includes a .htaccess file in the public directory – make sure it has been uploaded correctly. If you're using shared hosting, confirm with your provider that mod_rewrite is enabled and .htaccess files are allowed. If you're managing your own server, you may need to add the following to your site configuration:

    <Directory "/path/to/flarum/public">
        AllowOverride All
    </Directory>

# Nginx

Flarum includes a .nginx.conf file – make sure it has been uploaded correctly. Then, assuming you have a PHP site set up within Nginx, add the following to your server's configuration block:

    include /path/to/flarum/.nginx.conf;

# Caddy

Caddy requires a very simple configuration in order for Flarum to work properly. Note that you should replace the URL with your own and the path with the path to your own public folder. If you are using a different version of PHP, you wil also need to change the fastcgi path to point to your correct PHP install socket or URL.

www.example.com {
    root /var/www/flarum/public
    rewrite {
        to {path} {path}/ /index.php
    }
    fastcgi / /var/run/php/php7.2-fpm.sock php
    header /assets {
        +Cache-Control "public, must-revalidate, proxy-revalidate"
        +Cache-Control "max-age=25000",
        Pragma "public" 
    }
    gzip
}

# Customizing Paths

By default Flarum's directory structure includes a public directory which contains only publicly-accessible files. This is a security best-practice, ensuring that all sensitive source code files are completely inaccessible from the web root.

However, if you wish to host Flarum in a subdirectory (like yoursite.com/forum), or if your host doesn't give you control over your webroot (you're stuck with something like public_html or htdocs), you can set up Flarum without the public directory.

Simply move all the files inside the public directory (including .htaccess) into the directory you want to serve Flarum from. Then edit .htaccess and uncomment lines 9-14 in order to protect sensitive resources. Finally, edit both index.php and the flarum executable, and update the paths in the following lines to reflect your new directory structure:

require 'vendor/autoload.php';

        'base' => __DIR__,
        'public' => __DIR__,
        'storage' => __DIR__.'/storage',

# Importing Data

If you have an existing community and don't want to start from scratch, you may be able to import your existing data into Flarum. While there are no official importers yet, the community has made several unofficial importers:

• FluxBB
• MyBB
• phpBB
• SMF2

These can be used for other forum software as well by migrating to phpBB first, then to Flarum. Be aware that we can't guarantee that these will work nor can we offer support for them.