Merge branch 'doc-local-test' into 'master'

doc(readme): added example to start it locally with simulated domain

See merge request digitaldemocratic/digitaldemocratic!37
Josep Maria Viñolas Auquer 2022-01-04 07:52:49 +00:00
commit d6d64cb296
1 changed files with 9 additions and 2 deletions

View File

@ -118,8 +118,7 @@ Refer to the official documentation (https://docs.docker.com/compose/install/) o
### Setup ### Setup
Copy digitaldemocratic.conf.sample to digitaldemocratic.conf and edit to satisfy your needs. At least (to development) you should adapt Copy digitaldemocratic.conf.sample to digitaldemocratic.conf and edit to satisfy your needs. At least (to development) you should adapt the DOMINI envvar to your root domain.
the DOMINI envvar to your root domain.
- PRODUCTION: You'll need a multidomain dns (or redirect all the subdomains) to your server IP. - PRODUCTION: You'll need a multidomain dns (or redirect all the subdomains) to your server IP.
- DEVELOPMENT: You'll have to edit your /etc/hosts and add all the required domains to your development server IP. - DEVELOPMENT: You'll have to edit your /etc/hosts and add all the required domains to your development server IP.
@ -134,6 +133,14 @@ the DOMINI envvar to your root domain.
- Etherpad: pad.<yourdomain.org> - Etherpad: pad.<yourdomain.org>
- (optional) FreeIPA: ipa.<yourdomain.org> - (optional) FreeIPA: ipa.<yourdomain.org>
NOTE: To test it in your computer without a domain you'll need to simulate a domain and set it in digitaldemocratic.conf and then add to your /etc/hosts this subdomains to your IP.
For example:
```
echo '192.168.0.5 mydomain.org admin.mydomain.org nextcloud.mydomain.org moodle.mydomain.org sso.mydomain.org api.mydomain.org wp.mydomain.org pad.mydomain.org oof.mydomain.org' >> /etc/hosts
```
### Customization ### Customization
Recursively copy the *custom.sampl* folder to *custom* and edit the yaml personalization files and substitute the image. Recursively copy the *custom.sampl* folder to *custom* and edit the yaml personalization files and substitute the image.