|hoccau 4f61d3747d add is_active to user model||10 months ago|
|requirements||10 months ago|
|sisyphe||10 months ago|
|.gitignore||10 months ago|
|.gitmessage||10 months ago|
|CHANGELOG.md||10 months ago|
|CONTRIBUTORS.txt||10 months ago|
|LICENSE||10 months ago|
|Makefile||10 months ago|
|README.md||10 months ago|
|config.env.example||10 months ago|
|manage.py||10 months ago|
|notes.txt||10 months ago|
|requirements.txt||10 months ago|
|setup.cfg||10 months ago|
On a Debian-based host - running at least Debian Stretch, you will need the following packages:
Note: if you’re serving the application with uWSGI and NGINX on a sub location, ensure
that you’ve added
route-run = fixpathinfo: to your uWSGI configuration (from
make help will show Makefile target
export) environnement variable
READ_CONFIG_FILE=0and set the configuration variable in the environnement.
make initwill create it and launch an interactive editor on it
maybe suitable for C.I.
export READ_CONFIG_FILE=0 DJANGO_SETTINGS_MODULE=sisyphe.settings.development
make init(it’s a shortcut for
Behind the scene
Makefile make the following step
It assumes that you have downloaded the last release of Sisyphe, extracted it and that you moved to that folder.
Start by creating a new virtual environment under
./venv and activate it:
$ virtualenv --system-site-packages ./venv $ source ./venv/bin/activate
Install the required Python packages depending on your environment:
$ pip install -r requirements/production.txt ... or ... $ pip install -r requirements/development.txt
Configure the application by setting the proper environment variables
depending on your environment. You can use the
give you the main variables with example values.
$ cp config.env.example config.env $ nano config.env $ chmod go-rwx config.env
Note that this
./config.env file will be loaded by default when the
application starts. If you don’t want that, just move this file away or set
READ_CONFIG_FILE environment variable to
Create the database tables - it assumes that you have created the database and set the proper configuration to use it:
$ ./manage.py migrate
That’s it! You should now be able to start the Django development server to check that everything is working fine with:
$ ./manage.py runserver
All the application files - e.g. Django code including settings, templates and
statics - are located into the
sisyphe/. It should
permit in a near future to distribute the application as a Python package and
install it system-wide.
Two environments are defined - either for requirements and settings:
development: for local application development and testing. It uses a SQLite3 database and enable debugging by default, add some useful settings and applications for development purpose - i.e. the
production: for production. It checks that configuration is set and correct, try to optimize performances and enforce some settings - i.e. HTTPS related ones.
You can override and extend statics and templates locally. This can be useful
if you have to change the logo for a specific instance for example. For that,
just put your files under the
Regarding the statics, do not forget to collect them after that. Note also that
local/ folder is ignored by git.
All the variable content - e.g. user-uploaded media, collected statics - are
stored inside the
var/ folder. It is also ignored by git as it’s specific
to each application installation.
So, you will have to configure your Web server to serve the
var/static/ folders, which should point to
Sisyphe is developed by Cliss XXI and licensed under the AGPLv3+.