ansible-role-im/README.md

Role Name

This role installs IM: https://gitea.caret.be/jens/im

Requirements

This role requires a database server to to be present where im can connect to

Role Variables

• im_admin_password: required, password for 'admin' user for im
• im_secret_key: optional Secret Key for Django app, defaults to random 56char string recreated on every run (This will invalidated current open sessions)
• im_user: user running the app, defaults to 'im' (this user will be created)
• im_home: path to install the im app in, defaults to /home/im (this path will be created)
• im_domain: the domain this app will run on (Needed for django's ALLOWED_HOSTS), default localhost
• im_db_name: database name, defaults to 'im'
• im_db_user: database user, defaults to 'im'
• im_db_password: database password, defaults to '', (ignored for unix socket connection)
• im_db_host: database server, defaults to '/run/postgresql/' for local unix socket connection
• im_db_port: database port, defaults to 5432 (ignored for unix socket connection)
• im_workers: the number of gunicorn http worker threads (defaults to 4)
• im_http_listen: the ip address to bind to, change this to ip address of the host if you use a reverse proxy on a different host, defaults to localhost
• im_http_port: the http port to bind to, defaults to 80

Dependencies

None

Example Playbook

- name: "Install im pantry app"
  hosts: im
  roles:
      - ansible-role-im
  vars:
      - im_domain: "im.example.com"
      - im_http_listen: "{{inventory_hostname}}"
      - im_admin_password: "test"

- name: "Install im pantry app"
  hosts: im
  roles:
      - ansible-role-im
  vars:
      - im_domain: "im.example.com"
      - im_http_listen: "192.168.1.112"

License

GPL-v3

Author Information

Jens (gitea.caret.be)