Installation instructions

So you decided to try Quanta out? Great Idea!

Installing Quanta on your server is extremely fast and straightforward. Learn with us how to do it in 6 easy steps:

Step 1: verify requisites

Quanta can only be installed on any UNIX-based OS (Linux, OSx, etc.). 

Windows / XAMP users, in order to use Quanta, will have to install a VM (VMware, VirtualBox, etc.) (check why?)

Additional requisites:

Apache 2.4+ or Nginx 1.15+
PHP 5.6+ (PHP 7 strongly advised!)

For Apache users:
the rewrite and headers module must be enabled. When running Apache 2 on Linux, you can normally do that with the a2enmod rewrite ; a2enmod headers commands.

You will also need PHP's image/gd and curl libraries enabled.

Step 2: download Quanta

Clone our repository in your www folder.

Make sure your webserver has write access into the newly created quanta folder.

Debian example (where the webserver user is www-data):
chmod -R 644 quanta
chown -R www-data quanta

If your are working in a local environment (i.e. on an OSX machine) make sure to use the right username instead of www-data.

Step 3: create a local domain / hostname for your project

This step is necessary if you are running Quanta on a local server (i.e. your own computer), as  if you wish to reach your own Quanta installation using a browser, you need a host pointing to your own machine. 

In UNIX / OSX you normally find the hosts file at:


An example of configuration could be:

To verify that you had set up the domain correctly, you can open a terminal window and run this command:


This command should respond with the IP address that you have setup in your hosts file.

Step 4: create a Virtual Host and point it to your Quanta folder

Do it the usual way.

For Apache:

In Apache2 you normally do this in:

(apache installation folder)/extra/httpd-vhosts.conf

or in the

(apache installation folder)/sites-available/yoursite.conf   

using directives similar to those:

DocumentRoot "/var/www/quanta"
ErrorLog "/usr/local/var/log/apache2/quanta-error.log"
CustomLog "/usr/local/var/log/apache2/quanta-access.log" combined

Restart Apache (i.e. apache2ctl restart), and you should be all set.

For Nginx:

The configuration to be used in Nginx, is contained in the quanta-nginx.conf file, included in your webroot.

Setup a server directive in your Nginx.conf file, and copy-paste the contents of quanta-nginx.conf inside it.

Make sure that you have setup the correct variables: 

listen is the port your nginx server is listening on

server_name should be your domain name

root is the system path of your quanta installation folder (not your specific quanta site folder!)

fastcgi params (i.e. fastcgi_pass) should be adapted (or even removed), according with your Nginx settings.

After doing the above steps, reload nginx (i.e. nginx -s reload) and proceed to the next step.

Step 5: Run the install script

From your Quanta folder, run this command:

./doctor setup 

(change to your domain, of course!).

The Quanta doctor will now do everything for you.

Step 6: Run composer

Composer is an useful tool that will automatically download all Quanta dependencies for you. 

After installing composer, while staying in the quanta folder, run: 

composer install voilà! 

Well Done! Welcome in your new Quanta site!

If the install was performed correctly, you can now reach your site ( In our example, that would be ), and you should see your brand new Quanta site's homepage. 


Now you can move to the next step: Customizing your first Quanta pages.

Got any problem during the installation process? 

1) Check the Troubleshooting pages
2) ...or ask the Community
3) ...or contact us!