Comment
Author: Admin | 2025-04-28
SSH as a user that has full sudo privileges. Update your Ubuntu package sources:sudo apt-get update -ysudo apt-get upgrade -ysudo reboot Enter fullscreen mode Exit fullscreen mode 2. Bootstrap the Ansible installationexport OPENEDX_RELEASE=open-release-lilac.masterwget https://raw.githubusercontent.com/edx/configuration/open-release/lilac.master/util/install/ansible-bootstrap.sh -O - | sudo bash Enter fullscreen mode Exit fullscreen mode 3. Prep the Ansible ConfigurationCreate a directy for edx-configs where all the ansible configurations goes, download the configuration variables there, and generate strong passwords for different services like different MySQL users and MongoDB.mkdir edx-configs && cd edx-configssudo wget https://raw.githubusercontent.com/edx/configuration/open-release/lilac.master/playbooks/sample_vars/passwords.ymlsudo wget https://raw.githubusercontent.com/cubiteDevops/do-edx-configs/main/vars.ymlwhile IFS= read line; do REPLACE=$(LC_ALL=C tr -dc 'A-Za-z0-9' | head -c35) && echo "$line" | sed "s/\!\!null/'$REPLACE'/"; done sudo tee ./my-passwords.yml Enter fullscreen mode Exit fullscreen mode Be sure to save the generated passwords in a safe place 4. Download the ThemeCreate a directory for theming assets and download Lilac theme there.mkdir /edx-themes && sudo chmod -R 777 /edx-themes && cd /edx-themesgit clone https://github.com/cubitetech/theme -b lilac cubite-theme Enter fullscreen mode Exit fullscreen mode This theme is responsive and made with one of the best frontend technologies, TailwindCSS. 5. Install Open edXThese instructions will potentially destroy the server they are run on, you should only do them on a freshly installed virtual machineThis can take some time, perhaps an hour.cd /edx/app/edx_ansible/edx_ansible/playbooks/ && git checkout open-release/lilac.mastersudo /edx/app/edx_ansible/venvs/edx_ansible/bin/ansible-playbook -c local ./openedx_native.yml -i 'localhost,' -e@/root/edx-configs/my-passwords.yml -e@/root/edx-configs/vars.yml Enter fullscreen mode Exit fullscreen mode ImportantUbuntu may alert you that a newer version of Ubuntu is available when you SSH into your server and may suggest that you run do-release-upgrade to upgrade to that newer version. Don’t do it.Pip may alert you that there is a newer version of pip available and may suggest that you run pip install --upgrade pip to install it. ** Don’t do it**. 6. Important Open edX Platform Folders /edx/appapplication software files for all Open edx modules /edx/app/edx_ansible/edx_ansible/playbooksall Ansible playbooks. You’ll learn a lot about how Ansible works simply by learning more about its folder structure /edx/app/edx_ansiblelocation to store server-vars.yml (further described in downstream repos) /edx/bin“home” folder for all pip, ansible, and bash admin utilities /edx/etcconfiguration files for all edx modules /edx/varall data (app, logs, etcetera) 7. Add SuperuserAfter the installation is successful you need a superuser to be able to access the Django admin portal. To add superuser to your instance, SSH to the server and run the following commandsudo -H -u edxapp bashsource /edx/app/edxapp/edxapp_envcd /edx/app/edxapp/edx-platformpython manage.py lms --settings=production createsuperuser Enter fullscreen mode Exit fullscreen mode The prompt asks for a username, an email, and a password. After the user creation is complete visit http://public\_ip\_of\_your\_server/admin and login with the username (not the email) and password you picked previously. This user has full access to your platform, Make sure you save your username and password in a secure place. 8. Enable SSL certificateInstalling an SSL certificate on your OpenX server is the best way to ensure security for both yourself and your students. The installation process only takes a few minutes.It's highly recommended to install an SSL certification as soon as possible to keep users safe
Add Comment