User Tools

Site Tools



SHiNeMaS Serveur installation guide


Debian packages

On Debian or any other distribution like Ubuntu or Mint, SHiNeMaS uses Python version 3 and Postgresql (9.3 < ) :

$ sudo apt-get install python3
$ sudo apt-get install postgresql

Python packages

To facilitate python packages installation it’s better to use python packages manager 'pip' : $ sudo apt-get install python3-pip

  • python-psycopg (connection to postgresql with python) :

$ sudo apt-get install python3-psycopg2
$ sudo pip3 install psycopg2

  • Django (2.0) :

$ sudo pip3 install Django==2.0

  • Other python packages (jsonfield, django-autocomplete-light, bokeh) :

$ sudo pip3 install jsonfield==2.0.2
$ sudo pip3 install django-autocomplete-light==3.3.5
$ sudo pip3 install bokeh==1.2.0
$ sudo pip3 install django-querysetsequence==0.11

Download code source

Download SHiNemaS' source code link to v1.1

$ tar xvzf shinemas1.1.tar.gz
$ cd “shinemas/”

Database creation & initialzation

First, you need to create a PostgreSQL superuser.
$ sudo su postgres
$ createuser -s -P pguser
$ exit
where pguser is the username you want to use as the PostgreSQL superuser. You'll have to fill a pguser_passsword for this user.
Edit the pg_hba.conf file (postgresql configuration file) :
$ sudo pluma /etc/postgresql/9.x/main/pg_hba.conf

pluma may not be your default text editor, in that case you case use gedit

$ sudo gedit /etc/postgresql/9.x/main/pg_hba.conf
9.x is your postgresql version

#For Unix socket change anthentication method to “md5” (“peer” by default)
# "local" is for Unix domain socket connections only
local   all             all                                     md5

Restart Postgresql :
$ sudo /etc/init.d/postgresql restart

Then create the database
$ createdb -U pguser shinemasdb

Edit shinemas settings file
$ sudo pluma
$ sudo gedit
Edit the parameters, this configuration should work :

ALLOWED_HOSTS = ['','//'] #example :
  'default': {
      'ENGINE': 'django.db.backends.postgresql_psycopg2', # Add 
'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
      'NAME': 'shinemasdb',        # Or path to database file if using sqlite3.
      'USER': '//pguser//',         # Not used with sqlite3.
      'PASSWORD': '//pguser_password//',     # Not used with sqlite3.
      'HOST': '',  #Set to empty string for localhost. Not used with sqlite3.
      'PORT': '',  # Set to empty string for default. Not used with sqlite3.
      'ATOMIC_REQUESTS': True     
#we use sqlite if test are run
#if 'test' in sys.argv:
#    DATABASES['default'] = {'ENGINE': 'django.db.backends.sqlite3'}
# Local time zone for this installation. Choices can be found here:
# although not all choices may be available on all operating systems.
# If running in a Windows environment this must be set to the same as your
# system time zone.
TIME_ZONE = 'Europe/Paris'
# Absolute path to the directory that holds media.
# Example: "/home/media/"
MEDIA_ROOT =  "///your/storing/folder/here//" #example : /var/store/shinemas/

Database initialization:

$ python3 migrate
$ python3 createsuperuser

Fill information to create a superuser for shinemas.

Deploy and use SHiNeMaS

Test installation

From the repository that contains SHiNeMaS source code :
$ python3 runserver
Keep the terminal open
Open a web browser and write the following URL :\\

SHiNeMaS home page should now be displayed.

Deploying SHiNeMaS with Apache

The best way is to read this article on Django documentation.

en/install_server.txt · Last modified: 2019/12/20 13:08 by