Quick Start

WARNING This documentation is for Pydio 7. Looking for Pydio 8 docs?

Deploy Pydio in a couple of steps :

  1. Run through the diagnostic and fix your server configurations
  2. Run through the installer to be up and running quickly
  3. Use Pydio.

Run through the diagnostic and fix the necessary errors

At very first run, a diagnostic tool will check a couple of features and configurations of your server, and will report errors or warning as it find them, along with suggestions for fixing the issues.


While “Warnings” can be generally ignored without preventing the application from running, you should still try to fix them if you can, as you will surely encounter problems at one point or another.

“Error” failing tests must be fixed before going further, otherwise the application will very surely crash.

Once you think you have correctly fixed the issue, simply reload the page to see if the test now correctly passes. If you ever need to re-run this test page later, you can access it by calling runTests.php at the root of your Pydio install path. However, for security reasons, you will first have to edit this file manually and comment out the first line of code :

// die("You are not allowed to see this page ...")

See the How-To’s for an exhaustive list of tests and solutions.

Pydio provides you a GUI-based installer that will guide you through the basic configurations.

  • Admin access: Define the master user name and password that you will use to connect as an administrator user.


  • Configuration Storage: defines a basic storage type for all Pydio configuration data. These are the internal application data (users definitions, workspaces parameters, etc), not the actual business data (your files). Use a DB-based storage, the no-db is still active for backward compatibility but should be considered as deprecated. You can use a MySQL, PostgreSQL or Sqlite server. The latter is a good option for a quick start, as it will create a simple in-file DB in your Pydio data folder. You should use MySQLi with php7.


  • Advanced Options: Two major parameters here:
    • Encoding: the “Encoding” parameter must be correctly set otherwise you will very probably bump into problems if you upload files with names containing non-ascii characters (like french èé, german ü, etc;…). On a Linux install, the detected value will generally display an ENCODING (like UTF-8), but make sure to set it with a LOCALE.ENCODING value, like en_US.UTF-8, or fr_FR.UTF-8, etc… Login to your server and type ‘echo $LANG’ in a console and copy the result. Windows should be left empty.
    • Server Path: the server path should be automatically detected by the installer, but make sure that it’s correct. It is the path of Pydio install from the webroot. E.g if Pydio is installed on https://yourdomain.com/path/to/pydio , must be /path/to/pydio. This is important as it is used for the rewrite rules.


  • License Options: There you can input your license name and license signature. If you don't have any of these, you still can start 30 days trial, and enter your license later.


Once you are ready to go, click on “Install Pydio” and the page should refresh and provide you a login dialog. Use the admin login you just defined to enter. You’re in!

Back to top