Skip to main content

​
Prerequisites

Before you begin, make sure you have the following installed:
  • Docker Desktop (includes Docker Compose)
  • Git (to clone the repository)
  • A text editor for configuration
Docker Desktop is available for Windows, macOS, and Linux. Make sure to start Docker Desktop before proceeding.

​
Installation

1

Clone the Repository

First, clone the CompuTécnicos repository to your local machine:
git clone <your-repository-url> computecnicos
cd computecnicos
2

Configure Environment Variables

Copy the example environment file and configure it with your settings:
cp .env.example .env
The default configuration works out of the box for local development. Here are the key variables:
.env
# Application ports
APP_PORT=8080
DB_PORT=3306
PMA_PORT=8081

# Database credentials
DB_NAME=computecnicos
DB_USER=computecnicos_user
DB_PASS=computecnicos_secret
MYSQL_ROOT_PASSWORD=root_secret

# PayPal configuration (sandbox mode)
PAYPAL_CLIENT_ID=your_paypal_client_id
PAYPAL_CLIENT_SECRET=your_paypal_client_secret
PAYPAL_ENVIRONMENT=sandbox

# Electronic invoicing
FE_PROVIDER=alegra
FE_SIMULATE=true
For local development, you can use the default values. The database will be automatically initialized with sample data including products, categories, and brands.
3

Start the Application

Build and launch all services with a single command:
docker-compose up -d --build
This will:
  • Build the PHP/Apache application container
  • Start a MySQL 8.0 database
  • Automatically import the database schema and sample data
  • Configure networking between services
Wait for the containers to start. You can check the status with:
docker-compose ps
The first build may take 2-3 minutes as it downloads images and installs dependencies. Subsequent starts will be much faster.
4

Access the Application

Once the containers are running, access the application at:The database comes pre-loaded with:
  • 4 product categories (Laptops, Computadoras, Componentes, Accesorios)
  • 8 brands (ASUS, HP, Lenovo, Dell, MSI, Corsair, Logitech, Kingston)
  • 15 sample products with real specifications
  • Complete database schema with all features enabled

​
Verify Installation

To verify everything is working correctly: 
docker-compose ps
You should see the app and db containers running with healthy status.

​
Default Access

The application is now ready to use with these default endpoints:
ServiceURLNotes
Websitehttp://localhost:8080Customer-facing e-commerce site
Admin Panelhttp://localhost:8080/admin/Backend management interface
phpMyAdminhttp://localhost:8081Database management (dev profile only)
phpMyAdmin is only available when using the dev profile. To enable it, use:
docker-compose --profile dev up -d

​
What’s Included

Your fresh CompuTécnicos installation includes:
  • Full E-commerce Platform: Product catalog, shopping cart, checkout
  • Payment Integration: PayPal sandbox configuration
  • Electronic Invoicing: Alegra/Siigo integration in simulation mode
  • Inventory Management: Stock tracking and supplier management
  • Order Management: Complete order lifecycle with status tracking
  • User System: Customer accounts with profile management
  • Admin Dashboard: Full backend for managing products, orders, and inventory
  • Review System: Customer reviews with ratings and images
  • Sample Data: 15 products across 4 categories to explore features

​
Common Commands

Here are the most frequently used commands: 
docker-compose up -d

​
Next Steps

Now that CompuTécnicos is running, you can:

Docker Setup Guide

Learn about advanced Docker configuration and deployment

Configuration

Configure PayPal, invoicing, and environment settings

Admin Guide

Learn how to manage your store from the admin panel

API Reference

Explore the available APIs and endpoints

​
Troubleshooting

​
Port Already in Use

If port 8080 is already in use, change the APP_PORT in your .env file:
.env
APP_PORT=8090
Then restart the containers: 
docker-compose down
docker-compose up -d

​
Database Connection Failed

If the application can’t connect to the database:
  1. Check if the database container is healthy: 
    docker-compose ps
  2. View database logs for errors: 
    docker-compose logs db
  3. Restart the database container: 
    docker-compose restart db

​
Composer Dependencies Failed

If composer installation fails during build: 
# Clear Docker cache and rebuild
docker-compose down
docker-compose up -d --build --force-recreate

​
Need Help?

If you encounter issues not covered here:
  • Check the Docker Setup Guide for detailed troubleshooting
  • Review container logs with docker-compose logs
  • Ensure Docker Desktop is running and has sufficient resources
  • Verify all required ports are available

Build docs developers (and LLMs) love

Get started for freeTalk to us