website/content/docs/self-hosted/dependencies.md

title	description	lead	date	lastmod	draft	images	menu	weight	toc
Database and cache	mCaptcha server requires dependencies like a Postgres database and a Redis cache	mCaptcha server requires dependencies like a Postgres database and a Redis cache	2021-07-21 14:49	2021-07-21 14:49	false		docs parent Self-Hosted	534	true

Notes

Database

• Database migrations are baked into the server binary so don't worry about them.

• When compiling from source, unset database configuration(comment out database configuration/ unset relevant environment variables). mCaptcha uses sqlx database client library which checks SQL queries at compile time. So if you are starting with a fresh database without migrations applied, compilation will fail.

Redis

• Redis is an optional dependency. Currently, the non-Redis configuration doesn't persist CAPTCHA heat. So if there's a systems failure, CAPTCHA heat will be reset and visitor count will start from 0. For small installations, this should post a problem as heat is short lived and is reset anyways at cool down period.

• mCaptcha uses a custom Redis module called cache to overcome some of Redis' limitations.

Instructions

Once again, there are two ways to go about this:

1. Docker
2. Bare metal

Docker

Database

Download and run Postgres

docker create --name mcaptcha-postgres \
  -e POSTGRES_PASSWORD=<database-password> \
  -p 5432:5432 \
  postgres && docker start mcaptcha-postgres

Redis

docker create --name mcaptcha-cache \
  -p 6379:6379 \
  mcaptcha/cache && docker start mcaptcha-cache

See mCaptcha/cache for more details.

1. Install Postgres if you don't have it already.

For Debian based distributions:

sudo apt install postgres

2. Create new user for running mCaptcha

$ sudo useradd -b /srv -m -s /usr/bin/bash mcaptcha

3. Create new user in Postgres

$ sudo -iu postgres # switch to `postgres` user
$ psql
postgres=#  CREATE USER mcaptcha WITH PASSWORD 'my super long password and yes you need single quote';
$  createdb -O mcaptcha mcaptcha # create db 'mcaptcha' with 'mcaptcha' as owner

4. Install mCaptcha/cache

See mCaptcha/cache for more details.