Using Docker Compose¶

This page documents the basic steps to use Docker Compose to run ZJUI-Learn. It does not cover vital information for production usage such as database backups or high availability.

Getting started¶

Follow the steps to install ZJUI-Learn with local source code. Then run this command in the root folder:

docker compose -f docker-compose-production.yml up

Then access ZJUI-Learn from port 3000.

Configuration¶

ZJUI-Learn can be configured by a config.json in the root of the repository.

First make the file config.json in your root repository.
Add the following line to docker-compose-production.yml under services.pl.volumes:
```
- ./config.json:/PrairieLearn/config.json
```

The config.json file should contain appropriate overrides for the keys in lib/config.ts.

Reverse Proxy¶

Read more about implementing a reverse proxy in the general setup documentation.

Authentication¶

Read more in the authentication documentation.

Admin User¶

Find the name of your running ZJUI-Learn container by running
```
docker ps
```
which will output multiple columns of information about your running container(s). Look for the prairielearn/prairielearn image and copy its corresponding name. For example, the name of the ZJUI-Learn container in this docker ps output is upbeat_roentgen:
```
CONTAINER ID  IMAGE                      COMMAND              CREATED      STATUS      PORTS                   NAMES
e0f522f41ea4  prairielearn/prairielearn  "/bin/sh -c /Prai…"  2 hours ago  Up 2 hours  0.0.0.0:3000->3000/tcp  upbeat_roentgen
```

Open a shell in your ZJUI-Learn container by running
```
docker exec -it CONTAINER_NAME /bin/bash
```

Then follow along at Admin User to set up ZJUI-Learn.

Adding SSH Keys¶

To get courses through GitHub we will need to configure the SSH keys in the container. Every time the container is destroyed, the keys are lost, so we need to make the keys the same as the Host.

Run the command on the host system

ssh-keygen

Which will generate a new key. Save this somewhere you will remember. Next you must bind mount these keys into the Docker container. In docker-compose-production.yml under volumes add

- /host/path/to/.ssh:/root/.ssh

To view the public key run the command

cat ~/.ssh/id_rsa.pub

Next to add the SSH key on GitHub go to SSH keys under profile settings. Add a title, then copy the public key into the Key field.

Adding courses¶

Adding courses is done through a GitHub repository. It is recommended to set up an organization under one user to which you can add all courses.

To make sure the courses remain if the Docker container goes down we must bind mount the folder in which courses are stored to the host machine, in docker-compose-production.yml under volumes add

- host/place/to/store/courses/:/container_courses_dir/

Once you have a course created, on ZJUI-Learn go to Admin then scroll down to Courses. Here click Add Course. Add the relevant information, take extra care that under Path you use the bind mounted path.

For example:

Path: /container_courses_dir/mycourse

To clone the course into ZJUI-Learn:

Go to the course GitHub repository you wish to put on ZJUI-Learn, click code and then SSH.
Copy the SSH URL and paste it under the Repository section. Go back to the homepage, and you should see the course there.
Click on the course, then Sync.
Click on Pull from remote git repository which will then clone all the files into the specified directory.

Support¶

See here for extra information.