Docker RosarioSIS

A Dockerfile that installs the latest RosarioSIS. This file pulls from the default branch, but can be easily modified to pull from any other available branch or tagged release.

Installation

Minimum requirements: Docker & Git working.

You can pull the built image from DockerHub rosariosis/rosariosis or:

$ git clone https://gitlab.com/francoisjacquet/docker-rosariosis.git
$ cd docker-rosariosis
$ docker build -t rosariosis .

Usage

RosarioSIS uses a PostgreSQL database:

$ docker run --name rosariosisdb -d postgres
$ docker run -e "ROSARIOSIS_ADMIN_EMAIL=admin@example.com" -e "PGHOST=rosariosisdb" -h `hostname -f` -d -p 80:80 --name rosariosis --link rosariosisdb:rosariosisdb rosariosis

Setup database:

$ docker exec -it rosariosisdb /bin/bash
# psql -h localhost -p 5432 -U postgres
postgres=# CREATE USER rosario WITH PASSWORD 'rosariopwd';
postgres=# CREATE DATABASE rosariosis WITH ENCODING 'UTF8' OWNER rosario;
postgres=# \q

Port 80 will be exposed, so you can visit localhost/InstallDatabase.php to get started. Default username and password: admin.

Note: a docker-compose.yml file is available.

Environment Variables

The RosarioSIS image uses several environment variables which are easy to miss. While none of the variables are required, they may significantly aid you in using the image.

PGHOST

Host of the postgres data

PGUSER

This optional environment variable is used in conjunction with PGPASSWORD to set a user and its password for the default database that is used by RosarioSIS to store data.

PGPASSWORD

This optional environment variable is used in conjunction with PGUSER to set a user and its password for the default database that is used by RosarioSIS to store data.

PGDATABASE

This optional environment variable can be used to define a different name for the default database that is used by RosarioSIS to store data.

PGPORT

This optional environment variable can be used to define a different port for the default database that is used by RosarioSIS to store data.

ROSARIOSIS_YEAR

This optional environment variable can be used to define a year in the RosarioSIS settings.

ROSARIOSIS_LANG

This optional environment variable is used for make RosarioSIS to show in another language

ROSARIOSIS_VERSION

This optional environment variable is used to set the required version of RosarioSIS

SMTP

RosarioSIS will attempt to send mail via the host's port 25. In order for this to work you must set the hostname of the rosariosis container to that of host (or some other hostname that your can appear on a legal FROM line) and configure the host to accept SMTP from the container. For postfix this means adding the container IP addresses to /etc/postfix/main.cf as in:

mynetworks = 192.168.0.0/16 172.16.0.0/12 10.0.0.0/8 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128

Note: alternatively, you can use the Email SMTP plugin for RosarioSIS.