This is the main edX platform which consists of LMS and Studio.

Installation

Please refer to the following wiki pages in our configuration repo_ to install edX:

• edX Developer Stack_: These instructions are for developers who want to contribute or make changes to the edX source code.
• edX Full Stack_: Using Vagrant/Virtualbox this will setup all edX services on a single server in a production like configuration.
• edX Ubuntu 12.04 64-bit Installation_: This will install edX on an existing Ubuntu 12.04 server.

.. _configuration repo: https://github.com/edx/configuration .. _edX Developer Stack: https://github.com/edx/configuration/wiki/edX-Developer-Stack .. _edX Full Stack: https://github.com/edx/configuration/wiki/edX-Full-Stack .. _edX Ubuntu 12.04 64-bit Installation: https://github.com/edx/configuration/wiki/edX-Ubuntu-12.04-64-bit-Installation

License

The code in this repository is licensed under version 3 of the AGPL unless otherwise noted. Please see the LICENSE_ file for details.

.. _LICENSE: https://github.com/edx/edx-platform/blob/master/LICENSE

The Open edX Portal

See the Open edX Portal_ to learn more about Open edX. You can find information about the edX roadmap, as well as about hosting, extending, and contributing to Open edX. In addition, the Open edX Portal provides product announcements, the Open edX blog, and other rich community resources.

To comment on blog posts or the edX roadmap, you must create an account and log in. If you do not have an account, follow these steps.

. Visit open.edx.org/user/register_.

. Fill in your personal details.

. Select Create New Account. You are then logged in to the `Open edX

Portal`_.

.. _Open edX Portal: https://open.edx.org .. _open.edx.org/user/register: https://open.edx.org/user/register

Documentation

Documentation is managed in the edx-documentation repository. Documentation is built using Sphinx: you can view the built documentation on ReadTheDocs_.

You can also check out Confluence, our wiki system. Once you sign up for an account, you'll be able to create new pages and edit existing pages, just like in any other wiki system. You only need one account for both Confluence and JIRA, our issue tracker.

.. _Sphinx: http://sphinx-doc.org/ .. _view the built documentation on ReadTheDocs: http://docs.edx.org/ .. _edx-documentation: https://github.com/edx/edx-documentation .. _Confluence: http://openedx.atlassian.net/wiki/ .. _JIRA: https://openedx.atlassian.net/

Getting Help

If you’re having trouble, we have several different mailing lists where you can ask for help:

• openedx-ops_: everything related to running Open edX. This includes installation issues, server management, cost analysis, and so on.
• openedx-translation_: everything related to translating Open edX into other languages. This includes volunteer translators, our internationalization infrastructure, issues related to Transifex, and so on.
• openedx-analytics_: everything related to analytics in Open edX.
• edx-code_: anything else related to Open edX. This includes feature requests, idea proposals, refactorings, and so on.

You can also join our IRC channel: #edx-code on Freenode_.

.. _openedx-ops: https://groups.google.com/forum/#!forum/openedx-ops .. _openedx-translation: https://groups.google.com/forum/#!forum/openedx-translation .. _openedx-analytics: https://groups.google.com/forum/#!forum/openedx-analytics .. edx-code: https://groups.google.com/forum/#!forum/edx-code .. #edx-code on Freenode: http://webchat.freenode.net/?channels=edx-code

Issue Tracker

We use JIRA for our issue tracker, not GitHub Issues. To file a bug or request a new feature, please make a free account on our JIRA and create a new issue! If you’re filing a bug, we’d appreciate it if you would follow our guidelines for filing high-quality, actionable bug reports. Thanks!

.. _We use JIRA for our issue tracker: https://openedx.atlassian.net/ .. _our guidelines for filing high-quality, actionable bug reports: https://openedx.atlassian.net/wiki/display/SUST/How+to+File+a+Quality+Bug+Report

How to Contribute

Contributions are very welcome, but for legal reasons, you must submit a signed individual contributor’s agreement before we can accept your contribution. See our CONTRIBUTING file for more information – it also contains guidelines for how to maintain high code quality, which will make your contribution more likely to be accepted.

Reporting Security Issues

Please do not report security issues in public. Please email security@edx.org

.. _individual contributor’s agreement: http://open.edx.org/sites/default/files/wysiwyg/individual-contributor-agreement.pdf .. _CONTRIBUTING: https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst