Docker RosarioSIS ================= A Dockerfile that installs the latest [RosarioSIS](https://www.rosariosis.org/). 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](https://www.docker.com/) & Git working. You can pull the built image from [DockerHub rosariosis/rosariosis](https://hub.docker.com/r/rosariosis/rosariosis) or: ```bash $ git clone https://gitlab.com/francoisjacquet/docker-rosariosis.git $ cd docker-rosariosis $ docker build -t rosariosis . ``` ## Usage RosarioSIS uses a PostgreSQL database: ```bash $ 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: ```bash $ 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](https://www.rosariosis.org/email-smtp-plugin/) plugin for RosarioSIS.