language

app to create language test

License:	MIT

Requirements

1. Create an AWS Ubuntu Machine using free tier account (Ubuntu 16.04 LTS) using key pair value

2. Create a New Security Group with inboud rules, that allows ssh from any ip and tcp request on port any port

3. Right click the ec2 instance and from networking, change security group and assign this security group

4. Connect to the machine using following command

   $ ssh -i <yourpemfile.pem> ubuntu@<ip_address>

5. Setup Up Docker on your machine using following commands

   $ sudo apt-get update

   $ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

   $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

   $ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

   $ sudo apt-get update

   $ sudo apt-get install docker-ce

   $ sudo apt-get install docker-compose

6. Go to your freenom.com or any domain name service provider, create a domain and edit the freenom dns record so as to point to your server ipaddress

7. Go to AWS account and create a publicly accessible s3 bucket and under acounts section create api keys

8. Go the repository and edit following files:

   1. envs > .production > .caddy ---> change the languagetest.tk domain to your domain name
   2. envs > .production > .django ---> change the DJANGO_ALLOWED_HOSTS languagetest.tk domain to your domain name
   3. envs > .production > .django ---> edit the followings:

After the requirements are completed

• Once you have completed docker installation, including docker and docker-compose, follow following instructions

Instructions

1. Clone the repository

$ git clone https://github.com/kennedy-dev/language-test

2. Move to the survey directory

$ cd language-test

3. Build the app

• To run the application, we need to build it first using following command

  $ sudo docker-compose -f production.yml build

2. Make Migrations

• To run the application, we need to build it first using following command

  $ sudo docker-compose -f production.yml run django python manage.py makemigrations

3. Migrate the app

• To run the application, we need to build it first using following command

  $ sudo docker-compose -f production.yml run django python manage.py migrate

4. Set up Admin User

• To create an admin account, use this command:

  $ sudo docker-compose -f production.yml run django python manage.py createsuperuser
  

5. Set up initial data

• To create an admin account, use this command:

  $ sudo docker-compose -f production.yml run django python manage.py runscript loaddata
  

5. Run the app

• To run the application, we need to build it first using following command

  $ sudo nohup docker-compose -f production.yml up --build

6. Mail Setup for Password Reset

1. Go mailgun.com
2. create a free account
3. get api credentials
4. sudo nano .env/.production/.django

e. Go to admin panel, edit the sites to match your site e. Enter the api credentials you get from mailgun

MAILGUN_API_KEY=

DJANGO_SERVER_EMAIL=

MAILGUN_DOMAIN=

7. Access the app

• Go to your browser and type: http://<ip_address>

8. Sample demo of the app

• Go to https://languagetest.tk/