libreosteo/libreosteo-http repository overview

LibreOsteo

LibreOsteo is a business application designed for osteopaths.

It manages patients, folder and runs as a work portal on a folder patient.

Browser supported :

• Google Chrome or Chromium
• Firefox

Please use the last version of these browsers.

You can try the online demo at http://garthylou.pythonanywhere.com⁠ login : demo password : demo

⁠Installation with Docker

You can follow this Wiki page <https://github.com/libreosteo/LibreOsteo/wiki/Installation-sous-GNU-Linux-avec-Docker>_ in French

⁠Docker for testing only or with PostgreSQL

• Copy this repository in your local environment.

• Ensure you have docker installed on your machine ::

  make build make run

Point your browser on : http://localhost:8085/⁠ it will guide you towards creating the first admin user.

• To use PostgreSQL with your Docker container, you have to define into your .env file these values ::

  LIBREOSTEO_DB_STORAGE=volumes/libreosteo-db-storage DATA=volumes/data SETTINGS=settings LIBREOSTEO_BAK_STORAGE=volumes/libreosteo-backup POSTGRES_USER=libreosteo POSTGRES_PASSWORD=libreosteo

Then ::

make run-pg

• LIBREOSTEO_DB_STORAGE define the postgresql storage
• DATA define the volume where the data will be stored : index of the database and uploaded documents
• SETTINGS define the directory which contains settings into init.py file
• LIBREOSTEO_BAK_STORAGE define the volume where you can backup your database in PostgreSQL dump format.
• POSTGRES_USER and POSTGRES_PASSWORD defines the credential required for your PostgreSQL database

into your init.py file for settings you can have ::

DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', 'NAME': 'libreosteo', 'USER': 'PUT_YOUR_POSTGRES_USER_HERE', 'PASSWORD': 'PUT_YOUR_POSTGRES_PASSWORD_HERE', 'HOST': 'pg_1', 'PORT': '5432', } }

⁠Use it in production

You can use the software in production by changing some settings.

Settings are in the folder ::

LibreOsteo/settings/

There are some settings in this folder, the base_ settings is the main settings. All settings should use this base settings as reference. You can define your own base settings, but advice is to use standalone_ setting, and add a local.py file in this folder to define your own customization.

⁠Setting to avoid debug trace

::

DEBUG = False TEMPLATES[0]['OPTIONS']['debug'] = False

⁠Setting for Database

For example, to define postgresql as database backend instead of sqlite3 (the default), you can use this definition. ::

DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', 'NAME': 'libreosteo', 'USER': 'libreosteo', 'PASSWORD': 'libreosteo', 'HOST': '127.0.0.1', 'PORT': '5432', } }

You have to adapt your value with your installation, and configuration of the database used. But you can use other database backend, there is no specificity used in the software linked to the implementation of the database.

⁠Setting for Cryptograhic key for CSRF_

In order to have protection against CSRF_, you have to override and change the value of SECRET_KEY, with a value computed by this script for example_ like this : ::

SECRET_KEY = "T}wf)m[?494-xG?9oO7C#3|K$Ox^!:BEJ^g3S+:&t!@pvv1oR]"

.. _CSRF: https://en.wikipedia.org/wiki/Cross-site_request_forgery⁠ .. _this script for example: https://gist.github.com/mattseymour/9205591⁠

⁠Use Http Service to provide the web application

In order to have a compliant solution to serve libreosteo, you can use Apache HTTP Server or Nginx. Details for setting these http server are not provided at this step, but you can inspire you with this article <https://www.thecodeship.com/deployment/deploy-django-apache-virtualenv-and-mod_wsgi/>_ or this other one <https://docs.nginx.com/nginx/admin-guide/web-server/app-gateway-uwsgi-django/>_

Docker images are provided with uwsgi as provider of the webapp. Libreosteo-sock provides an execution on uwsgi with serving on sock and allow to bind with NGinx for distributing the app.