You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 11, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: docs/instructions.md
+19-20Lines changed: 19 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,29 +4,31 @@ This file contains all the instructions required to run the `api` locally. In ad
4
4
5
5
## Prerequisites
6
6
7
-
* Docker Desktop ([instructions for Mac](https://docs.docker.com/desktop/install/mac-install/))
8
-
* PostgreSQL 11 (for Mac, run in a terminal `$ brew install postgresql@11`)
9
-
* pgAdmin4 ([link for Mac](https://www.pgadmin.org/download/pgadmin-4-macos/))
10
-
* AWS CLI (for Mac, run in a terminal `$ brew install awscli`)
11
-
* Python 3.9 (if you want/need to run the api not in Docker)
7
+
- Docker Desktop ([instructions for Mac](https://docs.docker.com/desktop/install/mac-install/))
8
+
- PostgreSQL 11 (for Mac, run in a terminal `$ brew install postgresql@11`)
9
+
- pgAdmin4 ([link for Mac](https://www.pgadmin.org/download/pgadmin-4-macos/))
10
+
- AWS CLI (for Mac, run in a terminal `$ brew install awscli`)
11
+
- Python 3.9 (if you want/need to run the api not in Docker)
12
12
13
13
## AWS configuration
14
14
15
15
Current implementation of the notifications app makes use of several AWS resources. These were created in an AWS account which belongs to Ernout.
16
16
17
17
The following resources were created:
18
18
19
-
* SES
20
-
* S3 buckets
19
+
- SES
20
+
- S3 buckets
21
21
22
22
If a new sandbox (non-production) AWS SES is to be setup, the following is most likely necessary:
23
+
23
24
> "You need to set up the email address you want to mail to in amazon - I don't know why. So I authorized emailing to my email address through amazon's web ui." - Ernout
24
25
25
26
For application to be able to communicate with AWS APIs, it needs API keys. Ask your fellow teammates for the keys and do the following:
26
27
27
28
1. In the home directory create `.aws` folder.
28
29
1. In `~/.aws/` create file “credentials” (no extension)
The following changes must be made to the database:
46
48
47
-
| Table | Column | Row | New value | Comment |
48
-
|---|---|---|---|---|
49
-
|`services`|`email_from`||`noreply`| necessary for emails sending. `noreply` is the part of email address before `@`|
50
-
|`domain`|`domain`||`worth.systems`| if you want to create account using `worth.systems` email address. For `organisation_id` use an existing one in `organisation` table or create a new organisation|
51
-
|`provider_details`|`support_international`|`Firetext`|`true`| necessary for sms sending |
52
-
|`provider_details`|`active`|`mmg`|`false`| necessary for sms sending |
53
-
|`service_sms_senders`|`sms_sender`| all rows |`NotifyNL`| necessary for sms sending. This one is important not to miss. If `GOVUK` is used as `sms_sender`, app will get blocked from being able to send sms |
|`services`|`email_from`||`noreply`| necessary for emails sending. `noreply` is the part of email address before `@`|
52
+
|`domain`|`domain`||`worth.systems`| if you want to create account using `worth.systems` email address. For `organisation_id` use an existing one in `organisation` table or create a new organisation |
53
+
|`provider_details`|`support_international`|`Firetext`|`true`| necessary for sms sending|
54
+
|`provider_details`|`active`|`mmg`|`false`| necessary for sms sending|
55
+
|`service_sms_senders`|`sms_sender`| all rows |`NotifyNL`| necessary for sms sending. This one is important not to miss. If `GOVUK` is used as `sms_sender`, app will get blocked from being able to send sms|
54
56
55
57
## Running app
56
58
@@ -60,6 +62,7 @@ Follow the following steps to get the `Api` running locally in a Docker containe
60
62
1. Start PostgreSQL 11
61
63
1. Ask your fellow teammates for `FIRETEXT_API_KEY` and `FIRETEXT_INTERNATIONAL_API_KEY`
62
64
1. In the root of the repo create `environment.sh` with the following content
0 commit comments