Skip to content

Latest commit

 

History

History
80 lines (58 loc) · 2.68 KB

getting_started.rst

File metadata and controls

80 lines (58 loc) · 2.68 KB
Raw

Getting Started

Installation and basic concepts of the SODAR Core framework and its apps are detailed in this document.

Installation

The django-sodar-core package can be installed into your Django project from PyPI as follows. It is strongly recommended to specify a version tag, as the package is under active development and breaking changes are expected.

pip install django-sodar-core==0.13.4

Please note that the django-sodar-core package only installs Django apps<Django App>, which you need to include in a Django web site<Django Site> project. For instructions for integrating SODAR Core into an existing Django site or setting up a new site, see the projectroles app documentation <app_projectroles>.

SODAR Core Apps

The following Django apps will be installed when installing the django-sodar-core package:

  • projectroles: Base app for project access management and dynamic app content management. All other apps require the integration of projectroles.
  • adminalerts: Site app for displaying site-wide messages to all users.
  • appalerts: Site app and backend for raising alerts to users from apps.
  • bgjobs: Project app for managing background jobs.
  • siteinfo: Site app for displaying site information and statistics for administrators.
  • sodarcache: Generic caching and aggregation of data referring to external services.
  • timeline: Project app for logging and viewing project-related activity.
  • tokens: Token management for API access.
  • userprofile: Site app for viewing user profiles.

Requirements

Major requirements for integrating projectroles and other SODAR Core apps into your Django site are listed below. For a complete requirement list, see the requirements and utility directories in the repository.

  • Ubuntu (20.04 Focal recommended and supported) / CentOS 7
  • System library requirements (see the utility directory and/or your own Django project)
  • Python >=3.8 (NOTE: Python 3.7 no longer supported in SODAR Core v0.10.8+)
  • Django 3.2
  • PostgreSQL >=11 and psycopg2-binary
  • Bootstrap 4.x
  • JQuery 3.3.x
  • Shepherd and Tether
  • Clipboard.js
  • DataTables

For more details on installation and requirements for local development, see dev_core_install.

Next Steps

To proceed with using the SODAR Core framework in your Django site, you must first install and integrate the projectroles app. See the projectroles app documentation <app_projectroles> for instructions.

Once projectroles has been integrated into your site, you may proceed to install other apps as needed.