- PHP 5.4 (or higher)
- MySQL or PostgreSQL server
The following section explains how to install the application from the source files. But you can skip it and directly grap the latest release archive (openl10n-vX_X_X.zip) from the release section on GitHub which contains every compiled files needed to run the app.
Install from the sources¶
First, clone the source files via git:
git clone https://github.com/openl10n/openl10n.git cd openl10n
Then install the project’s dependencies. PHP dependencies are managed via Composer.
Download them using the
curl -sS https://getcomposer.org/installer | php php composer.phar install
You may want to install the Composer executable globally. Please refer to the official Composer documentation for more details.
For the new frontend side, you have nothing to do since the compiled scripts is already available from a CDN. But since the legacy app is being used, it’s recommended to have NodeJS and npm installed locally.
CSS compilation depends on Sass (which requires Ruby).
gem install sass
Compile the assets the Gulp task manager.
npm install npm install -g gulp gulp build --prod
Setup the database¶
When installing PHP dependencies via the
composer install command, a prompt should
have asked you about application configuration (eg. database credentials).
But you can also fill the configuration file
app/config/parameters.yml as an example).
Once the credentials configured, you can create the database schema by running the following commands:
app/console doctrine:database:create --env=prod --no-debug app/console doctrine:schema:create --env=prod --no-debug
You can also create a new user by running this interactive command:
app/console openl10n:user:new --env=prod --no-debug
Run the application¶
In order to access the application, access the
web/app.php file via your web
If you are using Nginx or Apache, please refer to the official Symfony documentation: Configuring a Web Server
If you want try it locally, just run the basic PHP built-in server via the
php app/console server:run command and then access
with your browser.