Skip to content

WIP: Running Open edX without Tutor guide#1385

Open
bmtcril wants to merge 10 commits intomainfrom
bmtcril/running-bare-metal
Open

WIP: Running Open edX without Tutor guide#1385
bmtcril wants to merge 10 commits intomainfrom
bmtcril/running-bare-metal

Conversation

@bmtcril
Copy link
Contributor

@bmtcril bmtcril commented Feb 3, 2026

This is a first pass doc authored iteratively with Claude Code in a fresh Ubuntu 24.04 Docker container. The different commits show the progress as we worked through various install pitfalls and eventually got to a working build with the essential MFEs all connecting. As near as I can tell everything was running, but it has not been thoroughly tested.

An important note is that I did no installation or configuration work. I set up Claude Code, told it to write the install doc, then had it perform all of the steps, fixing the doc as it went. A record of the final session is here.

There are large chunks of leftover documentation about the process and testing at the bottom, which I think are actually really useful for hunting down common issues and I'd argue that they should stay in one form or another.

Known issues:

  • It's unclear why some platform plugins were not showing up in INSTALLED_APPS, I think several parts of this doc can be cleaned up when we figure that out
  • This doesn't yet include or reference codejail setup
  • It should include how to install the demo course
  • There are some parts that need additional attention / rewrite, I'll cover them in-context with review comments
  • I suspect CMS login won't work and we'll need to set up OAuth for it
  • This is a dev focused setup, but doesn't have further instructions on how to develop from here. This could morph into a more developer friendly guide for how to do different types of development or a more production friendly guide that focuses more in implementing best practices to get a production grade server running

.. note::

**Container environments:** If running in a Docker container without systemd, use
``sudo service mysql start`` instead of systemctl commands.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suspect this is Claude being confused about something it tried to run, we should probably just pick service and try not to worry about the layers underneath

redis-cli ping
# Should return: PONG

5. Install and Configure Memcached
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure that we should worry about both memcached and redis, should probably just focus on a redis install at this point?

pip list | grep -i celery
# Should show Celery

11. Install Node.js Dependencies and Build Assets
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is repeated at step 17, I suspect it got confused and didn't know to copy the files so did it twice?

# Create superuser with --noinput (non-interactive)
./manage.py lms createsuperuser --username admin --email admin@example.com --noinput --settings=production

# Set the password using Python
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is silly, I think we can just set the DJANGO_SUPERUSER_EMAIL / DJANGO_SUPERUSER_PASSWORD / DJANGO_SUPERUSER_USERNAME env vars

Copy link
Contributor Author

@bmtcril bmtcril left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still some work to do, but want to get other eyes on it

@bmtcril
Copy link
Contributor Author

bmtcril commented Feb 3, 2026

Closing / reopning to kick RtD

@bmtcril bmtcril closed this Feb 3, 2026
@bmtcril bmtcril reopened this Feb 3, 2026
@sarina
Copy link
Contributor

sarina commented Feb 4, 2026

@bmtcril just FYI it seems like RTD is taking about 10 minutes to report build status back to GH. Clicking into the build you can see status & view the built docs.

@bmtcril
Copy link
Contributor Author

bmtcril commented Feb 4, 2026

@sarina yeah, yesterday RtD was dying in the middle of building and failed to report status back at all

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants