The server requirements are basically the same as for WordPress with the addition of a few ones:

We recommend to use at least PHP 7.2+

Install Composer

The Themosis framework uses Composer to manage its dependencies and easily load its files. Please follow the instructions here in order to install Composer either locally or globally on your computer.

On Windows, you can use the Composer Windows installer.

We recommend you to install Composer globally on your system.

Install the Themosis framework

Open your Terminal or Console and execute the following command:

composer create-project themosis/themosis my-project-name

This will create a directory called my-project-name on your computer and automatically download the latest WordPress version along with the latest Themosis framework version and its dependencies.

The public directory

The Themosis framework is not configured to be hosted like a classic WordPress project. Compared to a classic WordPress installation, a Themosis project root is not the web server public directory.

When configuring your web server, make sure to point the web server to the project htdocs directory.

Laravel Homestead

By default, the Themosis framework is packaged with Laravel Homestead so you can quickly start a local development environment.

If you want to develop your application with Homestead, you first need to have Vagrant installed on your computer. Once installed, open your Terminal or Console at project root and run the following command:

cd my-project-name
./vendor/bin/homestead make

The code will install at project root a group of files in order to bootstrap your virtual machine. Open the Homestead.yaml file and change the sites -> to value to point to the framework default public directory htdocs. Here is an example of a default configuration:

memory: 2048
cpus: 1
provider: virtualbox
authorize: ~/.ssh/
    - ~/.ssh/id_rsa
        map: /Users/username/web/my-project-name
        to: /home/vagrant/code
        map: homestead.test
        to: /home/vagrant/code/htdocs
    - homestead
name: themosis
hostname: themosis

For more information regarding Homestead configuration, please read the official documentation.

Once your configuration of Homestead is complete, from the Terminal or Console, run the following command:

vagrant up

Before visiting the browser in order to install WordPress, please make sure to first read the configuration guide.

Install the theme

By default, the default theme is no longer installed using Composer.

Instead, a CLI tool is now bundled with the framework and installed at project root. In order to install the new theme, connect into your local virtual machine, go to the project root and run the theme:install command from the terminal:

php console theme:install my-theme

The command will download and unzip a new theme into the htdocs/content/themes/my-theme directory. The script is also setting up the theme style.css file headers, the theme text domain and set it as the default theme for your WordPress application.

Install WordPress

Habitually, you define your environment variables like database name, database user, authentication salts and other WordPress configurations inside the wp-config.php file.

With the Themosis framework, those configurations are extracted from the web root and located in the parent folder, at project root through the use of a .env file.

Follow the configuration guide and see how to install your WordPress application.


Read the configuration guide


Subscribe to our mailing list and stay notified regarding future framework releases and its related services.

Made in Belgium