History

James Butters 1432d3e72a Revert "Replace old config ymls with newer mutagen ymls" This reverts commit `d3fc54655d`. Reason for revert: broke M1, non-mutagen setup Change-Id: Iddcfa0b086312b4ed22f400a61637ee248fd647d Reviewed-on: https://gerrit.instructure.com/c/canvas-lms/+/288011 Tested-by: Aaron Ogata <aogata@instructure.com> Tested-by: Service Cloud Jenkins <svc.cloudjenkins@instructure.com> Reviewed-by: Aaron Ogata <aogata@instructure.com> QA-Review: Aaron Ogata <aogata@instructure.com> Product-Review: Aaron Ogata <aogata@instructure.com>		2022-03-28 17:38:37 +00:00
..
README.md	update docker documentation	2022-03-28 16:43:20 +00:00
consul.md	Add rake task to populate Consul from dynamic_settings.yml	2017-09-19 18:08:39 +00:00
developing_with_docker.md	Revert "Replace old config ymls with newer mutagen ymls"	2022-03-28 17:38:37 +00:00
getting_docker.md	update docker documentation	2022-03-28 16:43:20 +00:00
vault.md	Add vault client to canvas	2020-02-03 19:00:13 +00:00

README.md

Using Docker to run Canvas

Prerequisites

You need Docker. Don't have Docker yet? Go here for details on getting it setup.

Development

Just on Linux (skip this on OSX), you may want to run this to avoid a few permissions issues first by granting Canvas docker containers write access to your Canvas folder:

setfacl -Rm u:9999:rwX,g:9999:rwX .
setfacl -dRm u:9999:rwX,g:9999:rwX .
sudo addgroup --gid 9999 docker-instructure
sudo usermod -a -G docker-instructure $USER

After logging back into your system (to recognize your new group), you should be able to edit or delete any files created by Canvas docker containers. If you're using this approach to grant Canvas write access, you can also disable the default built-in usermod hack that runs Canvas containers as your host UID instead (since this has been known to cause problems). This can be done by adding this to your ~/.bash_profile:

export CANVAS_SKIP_DOCKER_USERMOD=1

For everyone now, this command should get you going:

./script/docker_dev_setup.sh

Be sure to pay attention to any Next Steps output from the script that you may need to run.

Now you can do mutagen-compose up -d and you should be good to go. If you're using Dinghy-http-proxy or Dory you should be able to access Canvas by going to: http://canvas.docker/

For more information checkout Developing with Docker

Known Issues

Long URL Gateway 502

If a URL is long enough, you may see a Gateway 502 error. This problem has been patched in dinghy-http-proxy#36 however until a new release is cut the follow can be done as a work around:

In ~/.dinghy/proxy.conf add the following:

proxy_buffers 8 1024k;
proxy_buffer_size 1024k;

Restart dinghy afterwards.