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.2
Please note that the django-sodar-core package only installs Django apps, which you need to include in a Django web site project. For instructions for integrating SODAR Core into an existing Django site or setting up a new site, see the projectroles app documentation.
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 Development Installation.
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 for instructions.
Once projectroles has been integrated into your site, you may proceed to install other apps as needed.