- Clone the repository
- Enter the
setup_filesdirectory - Ensure the script files are executable:
chmod +x *.sh
- Run the
setup.shscript
- Go to the Google Developers Console (https://console.developers.google.com/).
- Create a new project or select an existing project.
- In the left sidebar, click on
Credentials. - Click on
Create credentialsand selectOAuth client ID. - Select
Web applicationas the application type. - Set the name for your OAuth client ID (e.g.,
eMoL). - In the
Authorized JavaScript originssection, add the URL of your eMoL application (e.g.,https://your-emol-url.com). - In the
Authorized redirect URIssection, add the following URIs:https://your-emol-url.com/accounts/google/login/callback/http://localhost:8000/accounts/google/login/callback/(for local development)- Note: Replace
your-emol-url.comwith your actual eMoL application URL.
- Click on
Createto generate the client ID and client secret. - Make a note of the generated client ID and client secret.
- Create a database named
emol - Create a user and password for eMoL to use
- Grant permissions to the eMoL user on the
emoldatabase
- In
/opt/emol/emol/settingsmake a copy ofsample_settings.py:
cp sample_settings.py settings.py
- Edit
settings.pywith a text editor - Change the value of
BASE_URLto the URL you will use - Set the value of
TIME_ZONEfor your locale - Locate the
AUTHLIB_OAUTH_CLIENTSsection in settings.py.- Set the value of
client_idto your Google client ID. - Set the value of
client_secretto your Google client secret.
- Set the value of
- Locate the
DATABASESblock in yoursettings.py- Update the block with the credentials you generated for the eMoL user
- The sample in
sample_settings.pyis for MySQL- If you are using a different database, consult the Django documentation
- Run the
db.pyscript to apply migrations and collect static files
- Run
setup_cron.shfrom thesetup_filesdirectory.- The script is idempotent, so you can run it multiple times without worry