Commit 667a27ae authored by Daniel W Bond's avatar Daniel W Bond
Browse files

added additional setup sections in the readme

parent cb6bf5ad
......@@ -107,6 +107,24 @@ Now, to configure your newly created database with the project settings, copy th
Run `python makemigrations` and `python migrate` to configure something called 'migrations', which allow you to make changes to the tables in your database without screwing up existing information. Then run `python createsuperuser` to create an admin account, using the same username and email as you'll access through CAS. Finally, run `python syncdb` to set up all the tables in your empty database.
### Email
Note: if you do not set this, the app will work 95% fine, except you will not be able to test sending email.
Amazon's Simple Email Service (SES) is set to the default on Bookshare, but these are actually generic settings that can handle any smtp server. Simply change the EMAIL_HOST, EMAIL_HOST_USER, and EMAIL_HOST_PASSWORD in, and change the EMAIL_PORT if necessary in
You will also need to change the default recipient email addresses in trades/; these are set by default to Amazon's testing email address with the actual user email addresses commented out above. (The same holds for deployment; change the recipent address to send emails to the actual recipients!)
### API Keys
Optional: sending email with Amazon's SES is set to the default on Bookshare. Create an SES account and set the host, user, and password in
Optional: if you want to upload user media files to Amazon's Simple Storage Service (S3), you can add API keys for an S3 bucket to and set MEDIA_S3 to True in
### Cacheing
Bookshare's urls are set by default to be cached for periods of time set so that ordinary user experience will not be impacted, but a substantial load will be lifted from a deployment server. However, this can be annoying when you're making and want to check small changes rapidly on development. You can edit the respective apps' files and remove the cacheing configurations, but make sure that you do not include such edits in any pushes!
### Haystack Configuration
When your database is empty, this won't do much good, but once you've created a few objects, run 'python update_index' to set up your database objects for search.
......@@ -130,6 +148,10 @@ threshold is reached.
You have three options from which to choose to serve your project for deployment. Apache + nginix, pure Apache, or pure nginx.
### Cacheing
Bookshare is in the process of being configured to use Redis for its cacheing.
## To-do
The list of to-do items is kept track of on the gitlab bookshare issues page. Ask the project manager if you have any questions!
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment