mirror of
https://gitlab.com/Chill-Projet/chill-bundles.git
synced 2025-11-24 04:47:46 +00:00
Change all content from rst format to markdown and correct spelling/grammar
This commit is contained in:
77
docs/source/installation/installation-development.md
Normal file
77
docs/source/installation/installation-development.md
Normal file
@@ -0,0 +1,77 @@
|
||||
## Installation for development or testing purpose only
|
||||
|
||||
⚠️ Use this method for development only. ⚠️
|
||||
|
||||
You will need:
|
||||
|
||||
- [Composer ](https://getcomposer.org)_;
|
||||
- [Symfony-cli tool ](https://symfony.com/download)_;
|
||||
- [docker ](https://docs.docker.com/engine/install/)_ and
|
||||
[docker-compose ](https://docs.docker.com/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
|
||||
Reference in New Issue
Block a user