Skip to content

[Feature:Developer] Containerize docs site#767

Open
roye2 wants to merge 5 commits into
mainfrom
containerize-docs-site
Open

[Feature:Developer] Containerize docs site#767
roye2 wants to merge 5 commits into
mainfrom
containerize-docs-site

Conversation

@roye2

@roye2 roye2 commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

See PR #748 .
Closes Submitty/Submitty#12685

Why is this change important and necessary?

Building the site requires installing Ruby locally and managing gem dependencies / versions. Containerizing the development website will make it easier for developers to test the site.

What is the new behavior?

You can now run the site with docker compose up

What steps should a reviewer take to test?

  1. Run docker compose up --build
  2. verify the site loads at http://localhost:4000
  3. verify that changes made to the md files in _docs are applied with a reload

Automated Testing and Documentation

Other information

What is different about this new PR over #748:

In PR #748, there was an issue where, when connecting to the server, it would put you on the port 0.0.0.0 and thus the browser would complain that the website was not secure.

In the new PR, nginx is used to communicate with the host machine as a proxy. You can visit the site at http://localhost:4000 normally and that is the url that will be displayed in your browser.

@github-project-automation github-project-automation Bot moved this to Seeking Reviewer in Submitty Development Jul 9, 2026
@roye2 roye2 changed the title Containerize docs site [Feature:Developer] Containerize docs site Jul 9, 2026
@roye2 roye2 marked this pull request as ready for review July 9, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Seeking Reviewer

Development

Successfully merging this pull request may close these issues.

Containerize documentation site

2 participants