This guide provides an Ansible playbook to install rConfig using Docker Compose for Debian 10+, Ubuntu LTS, and RHEL 9+ compatible systems.
rConfig v8 is the current version (Laravel 12, Vue.js 3):
- name: Install rConfig
hosts: rconfig
become: true
vars:
rconfig_dir: /opt/rconfig
db_password: "rconfig_secure_{{ 999999 | random }}"
root_password: "root_secure_{{ 999999 | random }}"
tasks:
- name: Create rConfig directory
file:
path: "{{ rconfig_dir }}"
state: directory
mode: "0755"
- name: Create docker-compose.yml
copy:
dest: "{{ rconfig_dir }}/docker-compose.yml"
content: |
services:
rconfig:
image: rconfig/rconfig:latest
container_name: rconfig
ports:
- "443:443"
environment:
- APP_ENV=production
- APP_DEBUG=false
- DB_HOST=db
- DB_DATABASE=rconfig
- DB_USERNAME=rconfig
- DB_PASSWORD={{ db_password }}
depends_on:
- db
volumes:
- rconfig_data:/var/www/html
restart: unless-stopped
db:
image: mariadb:10.11
container_name: rconfig-db
environment:
- MYSQL_ROOT_PASSWORD={{ root_password }}
- MYSQL_DATABASE=rconfig
- MYSQL_USER=rconfig
- MYSQL_PASSWORD={{ db_password }}
volumes:
- db_data:/var/lib/mysql
restart: unless-stopped
volumes:
rconfig_data:
db_data:
- name: Start rConfig containers
community.docker.docker_compose:
project_src: "{{ rconfig_dir }}"
state: present
- name: Wait for rConfig to be ready
uri:
url: https://localhost
status_code: [200, 301, 302]
validate_certs: false
register: result
until: result.status == 200 or result.status == 301 or result.status == 302
retries: 15
delay: 5
failed_when: false
- name: Display installation info
debug:
msg: |
rConfig installation complete!
Access: https://{{ ansible_host }}
Note: Using self-signed SSL certificate
Complete setup via web installer at first login
For traditional installation:
- name: Install rConfig on LAMP stack
hosts: rconfig
become: true
tasks:
- name: Install LAMP stack with PHP extensions
apt:
name:
- apache2
- mariadb-server
- php
- php-mysql
- php-gd
- php-xml
- php-mbstring
- php-curl
- php-zip
- php-bcmath
- libapache2-mod-php
state: present
- name: Download rConfig v8
get_url:
url: https://github.com/rconfig/rconfig/archive/refs/tags/v8.0.0.zip
dest: /tmp/rconfig.zip
- name: Extract rConfig
unarchive:
src: /tmp/rconfig.zip
dest: /var/www/html
remote_src: true
rconfig/rconfig:latest imageAny questions?
Feel free to contact us. Find all contact information on our contact page.