website/content/docs/self-hosting/ansible.md

title	description	lead	date	lastmod	draft	images	menu	weight	toc
Using Ansible	Deploy mCaptcha software using Ansible playbooks	Deploy mCaptcha software using Ansible playbooks	2023-12-03 15:14	2023-12-09 03:09	false		docs parent Self-Hosting	533	true

Ansible playbooks to install mCaptcha are available here.

Instructions

Installation

1. Clone the repository:

git clone https://git.batsense.net/mCaptcha/iac && cd iac

2. Create inventory file. You should have SSH access to the remote machine, and the user must have sudo privileges. Example inventory file:

   [mcaptcha_hosts]
   "mcaptcha_hosts"
   <node name> ansible_host=<node IP> ansible_user=<remote username>
   

   It is important that the group name be mcaptcha_hosts.

3. Configure installation by editing ansible/vars/mcaptcha/vars.yml. Most parameters have defaults, and the required parameters are annotated.

4. Run playbook:

	ansible-playbook -i path/to/inventory-file -f 10 ./ansible/mcaptcha.yml

Update

1. Pull changes from Git repository
2. Rerun playbook