README.md

Q-Translate Server

Drupal installation profile for Q-Translate Server.

Q-Translate is an application that helps to improve the translations of the Quran, by getting review and feedback from lots of people. http://info.qtranslate.org

Installation

• First install Docker: https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/#install-using-the-repository

• Then install ds, wsproxy and mariadb:

  • https://github.com/docker-scripts/ds#installation
  • https://github.com/docker-scripts/wsproxy#installation
  • https://github.com/docker-scripts/mariadb#installation

• Get the code from GitHub, like this:

  git clone https://github.com/Q-Translate/qtr_server /opt/docker-scripts/qtr_server
  

• Create a directory for the container: ds init qtr_server/ds @qtr.example.org

• Fix the settings:

  cd /var/ds/qtr.example.org/
  vim settings.sh
  

• Build image, create the container and configure it: ds make

Install Q-Translate Client

• See: https://github.com/Q-Translate/qtr_client#installation

• Setup oauth2 login between the client and the server: ds @qcl.example.org setup-oauth2-login @qtr.example.org or

  cd /var/ds/qcl.example.org/
  ds setup-oauth2-login @qtr.example.org
  

• Customize the local command 'remake': vim cmd/remake.sh

Access the website

• Tell wsproxy to manage the domain of this container: ds wsproxy add

• Tell wsproxy to get a free letsencrypt.org SSL certificate for this domain (if it is a real one): ds wsproxy ssl-cert

• If the domain is not a real one, add to /etc/hosts the lines 127.0.0.1 qtr.example.org and 127.0.0.1 qcl.example.org and then try in browser https://qtr.example.org and https://qcl.example.org

Import the translations

ds exec data/import.sh <lng>

If the argument lng is missing, then all the languages on settings.sh will be imported.

Backup and restore

ds backup data
ds backup qtr_dev
ds backup full
ds restore <backup-file.tgz>

Other commands

ds help

ds shell
ds stop
ds start
ds snapshot

ds inject set-adminpass.sh <new-drupal-admin-passwd>
ds inject set-domain.sh <new.domain>
ds inject set-emailsmtp.sh 'smtp_server' <smtp-server> <smtp-domain>
ds inject set-emailsmtp.sh 'gmail_account' <gmail-user> <gmail-passwd>
ds inject oauth2-client-add.sh <@alias> <client-key> <client-secret> <https://redirect-uri>
ds inject set-languages.sh

ds inject dev/clone.sh test
ds inject dev/clone-del.sh test
ds inject dev/clone.sh 01