Dolibarr Docker - Quick Reference Cheat Sheet¶

# Initial Setup
git clone <repository> dolibarr-project && cd dolibarr-project
cp .env.example .env    # Edit with your settings
task setup:init         # Create directories

# Development Environment
task services:start-with-tools     # Start with phpMyAdmin
task config:setup-dev-environment  # Configure for development
task utilities:health              # Check system health

# Production Environment  
task services:start                 # Start production services
task config:configure-company      # Setup company info
task config:enable-modules         # Enable essential modules

task services:start                 # Start with internal database
task services:start-with-tools      # Start with development tools  
task services:start-external        # Start with external database
task services:stop                  # Stop all services
task services:status                # Show service status
task services:logs                  # View all logs
task services:logs-app              # View application logs only

task config:setup-dev-environment   # Complete dev setup
task config:enable-modules          # Enable essential modules
task config:enable-api              # Enable REST API
task config:configure-company       # Setup company information
task config:show-config             # Display current config
task config:list-modules            # List enabled modules

task backup:backup                  # Complete backup (DB + files)
task backup:backup-db               # Database backup only
task backup:list-backups            # List available backups
task maintenance:update             # Update containers
task maintenance:cleanup            # Clean Docker resources

task utilities:health               # System health check
task utilities:shell-app            # Shell into application
task utilities:shell-db             # MySQL shell
task utilities:permissions          # Fix file permissions

DOLIBARR_PORT=18080
PHPMYADMIN_PORT=18081
DB_EXTERNAL_PORT=13306
DB_PASSWORD=dev-secure-password
DB_ROOT_PASSWORD=dev-secure-root-password
DOLIBARR_ADMIN_PASSWORD=dev-admin-password
TIMEZONE=America/New_York

DOLIBARR_PORT=8080
DB_PASSWORD=your-very-secure-password
DB_ROOT_PASSWORD=your-very-secure-root-password
DOLIBARR_ADMIN_PASSWORD=your-admin-password
DOLIBARR_URL_ROOT=https://erp.yourcompany.com
DOLIBARR_HTTPS=1
TIMEZONE=UTC
# Don't expose these in production:
# PHPMYADMIN_PORT=8081
# DB_EXTERNAL_PORT=3306

# Check what's using the port
lsof -i :8080

# Check Docker status
docker version && docker-compose version

# View detailed logs
task services:logs

# Reset everything (DANGEROUS - loses data)
task maintenance:reset-data

# Check database health
docker-compose exec dolibarr-db mysqladmin ping

# Test database connection
docker-compose exec dolibarr nc -zv dolibarr-db 3306

# View database logs
task services:logs-db

# Check web server status
curl -I http://localhost:8080

# Fix file permissions
task utilities:permissions

# Check configuration
task config:show-config

# Enable API module
task config:enable-api

# Test API connectivity
curl http://localhost:8080/api/index.php/explorer

# Check API configuration
task config:list-modules | grep API

# Quick system check
task utilities:health

# Service status
task services:status

# Resource usage
docker stats --no-stream

# Disk usage
df -h && docker system df

# Network connectivity
curl -f http://localhost:8080/index.php

task setup:init
task services:start-with-tools
task config:setup-dev-environment
task utilities:health

task services:start-with-tools
# Work on your project
task services:logs-app           # Check logs
task config:show-config         # Verify config
task services:stop              # Stop when done

# Setup production environment
task services:start
task config:configure-company
task config:enable-modules
task backup:backup
task utilities:health

task backup:backup              # Create backup first
task maintenance:update         # Update containers
task utilities:health           # Verify health

dolibarr-project/
├── .env                        # Environment configuration
├── .env.example               # Environment template
├── docker-compose.yml         # Service definitions
├── Taskfile.yml              # Task automation
├── custom/                    # Custom modules
├── logs/                      # Application logs
├── backups/                   # Data backups
├── db-init/                   # Database init scripts
└── docs/                      # Documentation
    ├── reference/             # Technical references
    ├── deployment-scenarios.md
    └── README.md

# System completely broken?
task maintenance:reset-data     # DANGER: Deletes all data!
task setup:init
task services:start-with-tools

# Database corrupted?
task services:stop
docker volume rm dolibarr_dolibarr-db-data
task services:start

# Out of disk space?
task maintenance:cleanup
docker system prune -a

# Container won't stop?
docker-compose kill
docker-compose down --remove-orphans