chill-bundles/docs/source/installation/installation-development.md

Installation for development or testing purpose only

⚠️ Use this method for development only. ⚠️

You will need:

• Composer _;
• Symfony-cli tool _;
• docker _ and docker-compose _
• node > 20 and yarn 1.22

First initialization

1. clone the repository and move to the cloned directory:

   git clone https://gitlab.com/Chill-Projet/chill-bundles.git cd chill-bundles

2. install dependencies using composer

   composer install

3. Install and compile assets:

   yarn install yarn run encore production

note double-check that you have the node version > 20 using the node --version command.

1. configure your project: create a .env.local file at the root, and add the admin password:

   for this installation mode, the environment should always be "dev"

   APP_ENV=dev ADMIN_PASSWORD=$2y$13$iyvJLuT4YEa6iWXyQV4/N.hNHpNG8kXlYDkkt5MkYy4FXcSwYAwmm

   note: if you copy-paste the line above, the password will be "admin".

2. start the stack using docker compose up -d, check the status of the start with docker compose ps

3. configure all the necessary third-party tools

# the first start, it may last some seconds, you can check with docker compose ps # run migrations symfony console doctrine:migrations:migrate # setup messenger symfony console messenger:setup-transports # prepare some views symfony console chill:db:sync-views # generate jwt token, required for some api features (webdav access, ...) symfony console lexik:jwt:generate-keypair

4. add some fixtures

This will truncate all the existing data of the database. But remember, we are in dev mode!

symfony console doctrine:fixtures:load

5. launch symfony dev-server

   symfony server:start -d

And visit the web page it suggests. You can log in with user center a_social and password password, or login admin with the password you set.

Stopping the server

symfony server:stop

Restart the webserver for a later start

symfony server:start -d

this will automatically start the full docker compose services