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
Copy file name to clipboardExpand all lines: HEROKU.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,6 +20,8 @@ Click the Heroku button and follow the instructions below:
20
20
6. Fill out the `JWK_BASE_URL` field with the URL to your LMS. The default value works for instructure hosted instances of Canvas, but will need to be modified if your JWK configuration is hosted at a different domain than `iss`.
21
21
7. Click the Deploy button and wait for the process to complete.
22
22
23
+
The above deploy uses the Heroku Postgres Mini plan by default. Please check `https://elements.heroku.com/addons/heroku-postgresql` for Heroku Postgresql plan details. You can upgrade Postgresql plan inside Heroku UI later.
24
+
23
25
### Step 2: Database Migration and Setup
24
26
Next we need to set up the database and insert our institution in to the appropriate table.
25
27
1. Click "Manage App" or go to `https://dashboard.heroku.com/apps/yourapp`. (Replace 'yourapp' with the name you gave in Step 1.2.)
Copy file name to clipboardExpand all lines: INSTALL.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,22 +28,22 @@ We strongly recommend managing the source code through Git. The benefit of this
28
28
If you prefer not to use Git, you can download a zip file of the latest release from the [Releases Page](https://github.com/ucfopen/UDOIT/releases). Unzip it in the directory on your server where UDOIT will live.
29
29
30
30
## .ENV Setup
31
-
UDOIT uses a `.env.local` file for storing configuration variables. To create it:
31
+
UDOIT uses a `.env` file for storing configuration variables. To create it:
32
32
33
-
1. Copy the file `.env.local.example` to `.env.local` by running
33
+
1. Copy the file `.env.example` to `.env` by running
34
34
```
35
-
cp .env.local.example .env.local
35
+
cp .env.example .env
36
36
```
37
37
2. Leave `APP_ENV` set to `prod`
38
38
> If you are setting up a development environment, set this to `dev` and follow the steps in [Installing Composer Dependencies](#installing-composer-dependencies) without the `--no-dev` flag to obtain all of the development packages.
39
-
3. Add your database information to thie`DATABASE_URL` variable. (The default value of `mysql://root:root@db:3306/udoit3` is suitable for running it on your local computer using Docker.)
39
+
3. Add your database information to the`DATABASE_URL` variable. (The default value of `mysql://root:root@db:3306/udoit3` is suitable for running it on your local computer using Docker.)
40
40
4. Modify the `BASE_URL` to match the URL of your instance of UDOIT. (The default value of `http://127.0.0.1:8000/udoit3` is suitable for running it on your local computer using Docker.)
41
41
5. Modify the `WEBPACK_PUBLIC_PATH` to match the `BASE_URL` you set. (The default value of `/udoit3/build` is suitable for running it on your local computer usind Docker. Example: If your `BASE_URL` is set to `http://127.0.0.1:8000`, your `WEBPACK_PUBLIC_PATH` should be `/build`.)
42
42
6. Set `APP_LMS` to the name of your LMS.
43
43
*`canvas` if you are using the Canvas LMS.
44
44
*`d2l` if you are using the D2l Brightspace LMS.
45
-
7.(Optional) You can change the default language for your entire UDOIT instance by adding the `DEFAULT_LANG` variable. Currently supported languages are English (`en`) and Spanish (`es`).
46
-
8. (Optional) If you are using UDOIT with a self-hosted instance of Canvas, you can add the `JWK_BASE_URL` variable and set it to the URL of your instance of Canvas. (Example: `JWK_BASE_URL="https://canvas.dev.myschool.edu"`)
45
+
7.If you are using UDOIT with a self-hosted instance of Canvas, you can add the `JWK_BASE_URL` variable and set it to the URL of your instance of Canvas. (Example: `JWK_BASE_URL="https://canvas.dev.myschool.edu"`)
46
+
8. (Optional) You can change the default language for your entire UDOIT instance by adding the `DEFAULT_LANG` variable. Currently supported languages are English (`en`) and Spanish (`es`).
47
47
48
48
## Docker
49
49
We provide a fast and simple way of setting up a local UDOIT instance through the use of Docker containers.
@@ -54,15 +54,15 @@ To set up the docker containers, you must first install [Docker](https://docs.do
54
54
### 2. Build the Containers
55
55
If you prefer to build the containers yourself, or you are actively developing UDOIT and need to rebuild the containers to test your cahnges, run the following command from within the UDOIT directory:
56
56
57
-
docker-compose -f docker-compose.nginx.yml up
57
+
dockercompose -f docker-compose.nginx.yml up
58
58
59
59
### 3. Wait
60
60
Wait for all of the containers to finish initializing. This can take over 15 minutes. You will know you are ready to proceed with the next step when you haven't seen any output in your terminal for a few minutes.
61
61
62
62
### 4. Set up the Database
63
63
The first time you start the containers, you will need to set up the database to handle all the information UDOIT generates as it runs. Run the following command:
64
64
65
-
docker-compose -f docker-compose.nginx.yml run php php bin/console doctrine:migrations:migrate
65
+
dockercompose -f docker-compose.nginx.yml run php php bin/console doctrine:migrations:migrate
66
66
67
67
> You will also need to run that command whenever you update to a new version of UDOIT.
68
68
@@ -72,7 +72,7 @@ Skip to [Testing your Setup](#testing-your-setup) to continue.
72
72
### 6. Stopping the Containers
73
73
If you ever want to stop the containers, you can do so with the following command:
If you are setting up UDOIT for local development through docker-compose, <YOUR_UDOIT_BASE_URL> in both the API developer key and the LTI developer key above should be set to `http://127.0.0.1:8000/udoit3`.
129
+
## DockerCompose Base URL
130
+
If you are setting up UDOIT for local development through `dockercompose`, <YOUR_UDOIT_BASE_URL> in both the API developer key and the LTI developer key above should be set to `http://127.0.0.1:8000/udoit3`.
131
131
132
132
---
133
133
## Update the Institutions Table
@@ -187,4 +187,4 @@ UDOIT now needs to be added to an account in Canvas. Follow these steps to add t
187
187
8. Paste the `Client ID` from the developer LTI Key you created earlier.
188
188
9. Click Submit.
189
189
190
-
You're done! "UDOIT" should now appear in the navigation menu of the course (or every course in the account) in which you installed it. If you installed it to an account, "UDOIT Admin" will also appear in the account navigation menu.
190
+
You're done! "UDOIT" should now appear in the navigation menu of the course (or every course in the account) in which you installed it. If you installed it to an account, "UDOIT Admin" will also appear in the account navigation menu.
0 commit comments