12 lines
3.3 KiB
XML
12 lines
3.3 KiB
XML
<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Self-Hosting on</title><link>/docs/self-hosting/</link><description>Recent content in Self-Hosting on</description><generator>Hugo -- gohugo.io</generator><language>en-US</language><atom:link href="/docs/self-hosting/index.xml" rel="self" type="application/rss+xml"/><item><title>Getting started</title><link>/docs/self-hosting/getting-started/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/self-hosting/getting-started/</guid><description>Get started There are two main ways to self-host mCaptcha:
|
|
Bare metal With Docker With Ansible</description></item><item><title>Deploy bare metal</title><link>/docs/self-hosting/bare-metal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/self-hosting/bare-metal/</guid><description>1. Install Database The following databases are supported:
|
|
Postgres MariaDB Please install the database of your choice. Then:
|
|
Create new database user for mCaptcha Create new database for mCaptcha mCaptcha binary has migrations baked-in and is applied on start up. The choice of database is described using the scheme of the database URL. For instance:
|
|
Postgres: postgres://mcaptcha:password@localhost:5432/mcaptcha Mariadb: mysql://mcaptcha:password@localhost:3306/mcaptcha 2. Optionally, install mCaptcha/cache We recommend this for larger instances.</description></item><item><title>Using Ansible</title><link>/docs/self-hosting/ansible/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/self-hosting/ansible/</guid><description>Ansible playbooks to install mCaptcha are available here.
|
|
Instructions Installation Clone the repository: 1git clone https://git.batsense.net/mCaptcha/iac &amp;&amp; cd iac Create inventory file. You should have SSH access to the remote machine, and the user must have sudo privileges. Example inventory file:
|
|
1[mcaptcha_hosts] 2&#34;mcaptcha_hosts&#34; 3&lt;node name&gt; ansible_host=&lt;node IP&gt; ansible_user=&lt;remote username&gt; It is important that the group name be mcaptcha_hosts.
|
|
Configure installation by editing ansible/vars/mcaptcha/vars.yml. Most parameters have defaults, and the required parameters are annotated.</description></item><item><title>Using Docker</title><link>/docs/self-hosting/docker/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/self-hosting/docker/</guid><description>With Docker 1. Configure mcaptcha is highly configurable.
|
|
Configuration is applied/merged in the following order:
|
|
path to configuration file passed in via MCAPTCHA_CONFIG ./config/default.toml /etc/mcaptcha/config.toml environment variables. See CONFIGURATION.md for configurable options.
|
|
2. Run image If you have already have a Postgres instance running, then:
|
|
docker run -p &lt;host-machine-port&gt;:&lt;port-in-configuration-file&gt; \ --add-host=database:&lt;database-ip-addrss&gt; \ -e RUST_LOG=debug \ -e DATABASE_URL=&quot;postgres://&lt;db-user&gt;:&lt;db-password&gt;@database:&lt;db-port&gt;/&lt;db-name&gt;&quot; \ mcaptcha/mcaptcha:latest If you don&rsquo;t have a Postgres instance running, you can either install one using a package manager or launch one with docker.</description></item></channel></rss> |