YMS Installation

1. Install requirements

1.1 Generic
- MariaDB
- Python 3
  - python3-bcrypt
- optional 
  - mupdf-tools for extended pdf file management

1.2 Native GUI
- Python GTK3

1.3 Web GUI
- Webserver
- PHP


2. Create database

Create a database for YMS on your server, as well as a MariaDB user who has
the privileges for accessing and modifying it.

  CREATE DATABASE yms;

Create database-user for application with minimum necessary rights.

  CREATE USER 'yms'@'localhost' IDENTIFIED BY '********';
  GRANT SELECT, INSERT, UPDATE, DELETE ON yms.* TO 'yms'@'localhost';

3. Run database import

Import the mariadb.sql file into your database, which will create the tables

  mariadb yms < mariadb.sql

Optional import some sample data

  mariadb yms < mariadb_sample.sql

4. Initialize document storage
Customize path and accessrights to your needs
  
  mkdir /var/local/yms
  mkdir /var/local/yms/thumb
  chown -R www-data /var/local/yms
  chmod -R 750 /var/local/yms

5. Upload webgui files

Upload all files and directories (except the install directory) to your
webserver.
Disallow access to include files (.inc). There is an example _htaccess
file.

6. Create and edit webgui config file

Rename sample configfile config.php-sample:

  mv config.inc-sample config.inc

Open config.inc in a text editor and fill in your database details.

7. Check file access rights for security

Configfile should be readable by webserver but not writeable.

  chmod 640 config.inc
  chgrp www-data config.inc

8. Start using YMS

Start your browser and login to YMS with the default username/password:
captain/captain

