rConfig V8 Core Docker Deployment

rConfig V8 Core Docker Deployment

Overview

rConfig V8 Core is the open-source edition of rConfig’s Network Configuration Management platform. This guide provides complete Docker deployment procedures for rapid, consistent installations.

rConfig V8 Professional Edition

For enterprise features and dedicated support, see the V8 Pro Docker Setup guide.

SSL/TLS Configuration

SSL/TLS is not configured by default. For production, see SSL Configuration Documentation.

Prerequisites

• Docker Engine 20.10+
• Docker Compose 2.0+
• Git
• Minimum 2GB RAM
• Port 8080 available (or configure alternative)

Quick Installation

1. Clone Repository

git clone https://github.com/rconfig/rconfig8coredocker.git
cd rconfig8coredocker

2. Configure Environment (Optional)

Default configuration works for most cases. To customize:

# Create/edit .env file
cat > .env << EOF
APP_URL=http://localhost:8080
DB_DATABASE=rconfig
DB_USERNAME=rconfig_user
DB_PASSWORD=rconfig_pass
MYSQL_ROOT_PASSWORD=root_password
EOF

Production Security

Always change default passwords for production: APP_DEBUG=false, strong DB_PASSWORD and MYSQL_ROOT_PASSWORD.

3. Build and Start

# Build containers (first time: 5-10 minutes)
docker compose build

# Start all services
docker compose up -d

# Verify status
docker compose ps

4. Run Installation

# Execute installation wizard
docker compose exec app php artisan v8core:install

# When prompted:
# - "Add a cron entry for task scheduling?" → yes

5. Access Application

Navigate to: http://localhost:8080

Default credentials:

• Username: admin@domain.com
• Password: admin

Security Critical

Change default credentials immediately after first login.

Post-Installation

Verify Services

# Check all services running
docker compose exec app supervisorctl status

# Expected output:
# apache2          RUNNING
# horizon          RUNNING
# redis-server     RUNNING
# schedule-run_00  RUNNING

Access Horizon Dashboard

Monitor queues at: http://localhost:8080/horizon

Fix Mail Configuration Errors (If Needed)

# For testing/development environments
docker compose exec app bash -c "cat >> /var/www/html/rconfig/.env << 'EOF'
MAIL_MAILER=log
MAIL_FROM_ADDRESS=noreply@rconfig.local
MAIL_FROM_NAME=rConfig
EOF"

docker compose exec app php artisan config:clear
docker compose restart app

Common Operations

View Logs

# Application logs
docker compose logs -f app

# Laravel logs
docker compose exec app tail -f /var/www/html/rconfig/storage/logs/laravel.log

Execute Artisan Commands

docker compose exec app php artisan [command]

# Examples:
docker compose exec app php artisan config:clear
docker compose exec app php artisan cache:clear
docker compose exec app php artisan horizon:status

Restart Services

# Restart all containers
docker compose restart

# Restart specific service
docker compose exec app supervisorctl restart horizon

Database Management

Backup

# Create backup with timestamp
docker compose exec -T db mysqldump -u root -proot_password rconfig > rconfig-backup-$(date +%Y%m%d-%H%M%S).sql

Automated Backups

Schedule with cron:

# crontab -e
0 2 * * * cd /path/to/rconfig8coredocker && docker compose exec -T db mysqldump -u root -proot_password rconfig > backups/rconfig-$(date +\%Y\%m\%d).sql

Restore

docker compose stop app
docker compose exec -T db mysql -u root -proot_password rconfig < rconfig-backup-20251222.sql
docker compose start app
docker compose exec app php artisan config:clear

Access Database

docker compose exec db mysql -u root -proot_password rconfig

Updates

Automated Update

chmod +x update.sh
./update.sh

The script handles: backup → rebuild → migrate → cache clear

Manual Update

# Backup
docker compose exec -T db mysqldump -u root -proot_password rconfig > backup.sql

# Rebuild with latest code
docker compose down
docker compose build --no-cache
docker compose up -d

# Migrate and clear caches
docker compose exec app php artisan migrate --force
docker compose exec app php artisan cache:clear
docker compose exec app php artisan config:clear
docker compose exec app php artisan horizon:terminate

Update to Specific Version

# Edit Dockerfile, change: ARG RCONFIG_VERSION=main
# To: ARG RCONFIG_VERSION=v8.1.0

docker compose build --no-cache --build-arg RCONFIG_VERSION=v8.1.0
docker compose up -d

Troubleshooting

Container Won’t Start

# Check logs
docker compose logs app

# Check port conflicts
netstat -tulpn | grep 8080

# Fix permissions
docker compose exec app chown -R www-data:www-data /var/www/html/rconfig/storage
docker compose exec app chmod -R 775 /var/www/html/rconfig/storage

Database Connection Errors

# Check database health
docker compose ps db

# Wait for initialization (first startup)
sleep 30 && docker compose restart app

# Recreate database
docker compose down
docker compose up -d db
sleep 30
docker compose up -d app

Permission Errors (500)

docker compose exec app chown -R www-data:www-data /var/www/html/rconfig/storage /var/www/html/rconfig/bootstrap/cache
docker compose exec app chmod -R 775 /var/www/html/rconfig/storage /var/www/html/rconfig/bootstrap/cache
docker compose exec app php artisan config:clear
docker compose exec app php artisan cache:clear

Horizon Not Processing

# Check status
docker compose exec app php artisan horizon:status

# Restart
docker compose exec app supervisorctl restart horizon
# OR
docker compose exec app php artisan horizon:terminate

Application Slow

# Clear caches
docker compose exec app php artisan optimize:clear

# Optimize
docker compose exec app php artisan optimize

# Restart
docker compose restart app

Security Hardening

Change Ports

Edit docker-compose.yml:

services:
  app:
    ports:
      - "9443:80"  # External port
  db:
    ports:
      - "127.0.0.1:3306:3306"  # Localhost only

Firewall Rules

# Allow specific IPs only
sudo ufw allow from 10.0.0.0/8 to any port 8080

Secure Files

chmod 600 .env
echo ".env" >> .gitignore

Performance Optimization

# Cache configuration
docker compose exec app php artisan config:cache
docker compose exec app php artisan route:cache
docker compose exec app php artisan view:cache
docker compose exec app composer dump-autoload --optimize

Migration from Traditional Install

# 1. Backup existing
mysqldump -u root -p rconfig > migration-backup.sql
tar -czf storage-backup.tar.gz /path/to/rconfig/storage

# 2. Deploy Docker (follow installation above)

# 3. Restore database
docker compose exec -T db mysql -u root -proot_password rconfig < migration-backup.sql

# 4. Restore storage
tar -xzf storage-backup.tar.gz
docker cp storage/. rconfig_app:/var/www/html/rconfig/storage/
docker compose exec app chown -R www-data:www-data /var/www/html/rconfig/storage

# 5. Clear caches
docker compose exec app php artisan config:clear
docker compose restart app

FAQ

Multiple instances on same server? Clone to different directories, change ports in docker-compose.yml.

Change database password after install?

docker compose exec db mysql -u root -proot_password -e "ALTER USER 'rconfig_user'@'%' IDENTIFIED BY 'new_password';"
docker compose exec app sed -i 's/DB_PASSWORD=.*/DB_PASSWORD=new_password/' /var/www/html/rconfig/.env
docker compose exec app php artisan config:clear
docker compose restart app

Use external database? Remove db service from docker-compose.yml, update .env with external credentials.

Enable HTTPS/SSL? See SSL Configuration Documentation.

Resources

• GitHub: https://github.com/rconfig/rconfig
• Docker Repo: https://github.com/rconfig/rconfig8coredocker
• Docs: https://v8coredocs.rconfig.com
• Support: https://github.com/rconfig/rconfig/issues
• YouTube: https://www.youtube.com/channel/rconfigv8Core

Next Steps

• Explore V8 Core Features
• Configure Network Devices
• Set Up Scheduled Tasks
• Join the Community