If you want to download a packaged, ready-to-use distribution of the most recent version of Thelia please download thelia.zip

Thelia is an open source tool for creating e-business websites and managing online content. This software is published under GNU General Public License v3.0.

A repository containing all thelia modules is available at this address : https://github.com/thelia-modules

• PHP
  • Required extensions :
    • PDO_Mysql
    • openssl
    • intl
    • gd
    • curl
    • dom
  • safe_mode off
  • memory_limit at least 128M, preferably 256.
  • post_max_size 20M
  • upload_max_filesize 2M
  • date.timezone must be defined
• Web Server Apache 2 or Nginx

As of MySQL 5.6, default configuration sets the sql_mode value to

STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

This 'STRICT_TRANS_TABLES' configuration results in SQL errors when no default value is defined on NOT NULL columns and the value is empty or invalid.

You can edit this default config in /etc/my.cnf and change the sql_mode to remove the STRICT_TRANS_TABLES part

[mysqld]
sql_mode=NO_ENGINE_SUBSTITUTION

Assuming your sql_mode is the default one, you can change the value directly on the run by running the following SQL Command

SET @@GLOBAL.sql_mode='NO_ENGINE_SUBSTITUTION', @@SESSION.sql_mode='NO_ENGINE_SUBSTITUTION'

For more information on sql_mode you can consult the MySQL doc

Thelia's archive builder's needs external libraries. For zip archives, you need PECL zip. See PHP Doc

For tar archives, you need PECL phar. Moreover, you need to deactivate php.ini option "phar.readonly":

phar.readonly = Off

For tar.bz2 archives, you need tar's dependencies and the extension "bzip2". See PHP Doc

For tar.gz archives, you need tar's dependencies and the extension "zlib". See PHP Doc

You can get the sources from git and then let composer install dependencies, or use composer to install the whole thelia project into a specific directory

$ git clone --recursive https://github.com/thelia/thelia path
$ cd path
$ git checkout 2.5.4
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar install

$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar create-project thelia/thelia path/ 2.5.4

If something goes wrong during the install process, you can restart Thelia install wizard with the following command : php composer.phar run-script post-create-project-cmd

You can install Thelia by different way

Installing thelia with the web install wizard allow to create an administrator, add some informations about your shop, etc

First of all, you have to configure a vhost as describe in configuration section.

The install wizard in accessible with your favorite browser :

https://yourdomain.tld/[/subdomain_if_needed]/install

For example, I have thelia downloaded at https://thelia.net and my vhost is correctly configured, I have to reach this address :

https://thelia.net/install

$ php Thelia thelia:install

You just have to follow all instructions.

This repo contains all the configuration needed to run Thelia with docker and docker-compose. Warning, this docker configuration is not ready for production.

It requires obviously docker and docker-compose

To install Thelia within Docker, run :

./start-docker.sh

It will ask you for a template name (usually your project name) if you don't have a .env file but you can create the .env by yourself, take a look at .env.docker to make your own.

If your folder template does not exist it will copy the "modern" template.

Next just go to http://localhost:8080 and you should see your Thelia installed !

And run the same command everytime you want launch your Thelia.

If you want add some sample data just add the option -demo

./start-docker.sh -demo

If you want to access your database from your computer (with DBeaver, Sequel Pro or anything else) by default the host is localhost and the port is 8086

To install Thelia, run :

make install

If you have been missing ACTIVE_FRONT_TEMPLATE and/or ACTIVE_ADMIN_TEMPLATE, you should set them up in .env.local and launch :

make install-front
make build

If you need an example of thelia database, you can run:

make import-demo-db

Thelia documentation is available at https://doc.thelia.net

See the documentation : https://doc.thelia.net/docs/contribute

If you submit modifications that adds new data or change the structure of the database, take a look to https://doc.thelia.net/docs/contribute#sql-scripts-modification

Join the conversation and help the community :

Twitter Discord StackOverflow Forum