Ansible Role - Socialhome

This role helps you deploy Socialhome using Ansible.

It will also set up Apache2 with a Let's Encrypt SSL certificate and, by default, install a PostgreSQL database (you can turn this off if you want).

Requirements

You need Ansible version 2.0 or higher.

Role Variables

For a complete list of variables, check defaults/main.yml. Here are the main ones you need to set:

• Admin Name: socialhome_admin_name

• Admin Email: socialhome_admin_mail

• Database Password: socialhome_db_password (default is "socialhome")

• Disable Registrations: Set socialhome_disable_registrations to true if you don't want registration enabled.

• Domain: socialhome_domain (default is "socialhome.local")

• Django Secret Key: socialhome_secret_key

• Email Settings:

  • Set the backend to "smtp" for using SMTP emails (only one type supported).
  • If not set to "smtp", emails will display in the console.
  • TLS is used for emails by default.

  Here are the email settings:

  • socialhome_email_backend
  • socialhome_email_host: usually "localhost"
  • socialhome_email_port: typically "587"
  • socialhome_email_host_user
  • socialhome_email_host_password
  • socialhome_email_from: default value is "noreply@socialhome.local"

Disabling PostgreSQL Database Installation

If you want to use an existing PostgreSQL database instead of installing a new one, set socialhome_db_install_postgres: false to skip the installation.

Dependencies

This role depends on the following roles:

• geerlingguy.nodejs
• jaywink.letsencrypt (only if HTTPS is enabled)

If you keep HTTPS enabled (which is recommended!), you must provide valid Let's Encrypt variables, like:

• letsencrypt_email: your email address
• letsencrypt_domain: your domain
• letsencrypt_request_www: false
• letsencrypt_force_renew: false

For a complete list, visit here.

Example Playbook

Here's a simple playbook to use with this role:

---
- hosts: myhost
  become: yes
  become_user: root

  vars:
    # Add your variables here or in a separate file

  roles:
    - jaywink.letsencrypt
    - jaywink.socialhome

License

This role is licensed under MIT.

Author Information

Created by Jason Robinson. Visit his website for more information.