gaetano88/vtenext-ce repository overview

⁠VTENext CE — Docker

Dockerized setup for VTENext CE⁠, the open-source CRM/ERP platform. Spin up a fully working local instance in minutes, no manual PHP or MySQL configuration needed.

Stack: PHP 7.4 + Apache · MySQL 8.0 · phpMyAdmin (optional)

⁠Quick start

git clone https://github.com/VTECRM/vtenext.git
cd vtenext
cp .env.example .env
docker compose up -d --build

Open http://localhost:8080/install.php⁠ and follow the installation wizard.

The DB settings are pre-configured automatically — just click through the wizard.

Default credentials (set in .env):

• Admin login: admin / admin
• DB host: db · DB name: vtenext · DB user: vtenext

⁠Installation wizard — known fixes included

This image includes two patches applied automatically at build/startup:

• utils.php: fixes check_db_utf8_support() called as global function instead of static method
• config.db.php: written from environment variables at container startup, so the wizard finds the DB settings pre-filled

⁠phpMyAdmin (optional)

docker compose --profile tools up -d

Open http://localhost:8081⁠

⁠Environment variables

APP_PORT=8080                          # VTENext port
DB_NAME=vtenext                        # Database name
DB_USER=vtenext                        # Database user
DB_PASSWORD=vtenext                    # Database password
DB_ROOT_PASSWORD=root                  # MySQL root password
VTENEXT_ADMIN_PASS=admin               # VTENext admin password
[email protected]
VTENEXT_USER_PASS=user
[email protected]
PMA_PORT=8081                          # phpMyAdmin port

⁠Useful commands

docker compose logs -f vtenext        # real-time logs
docker exec -it vtenext_app bash      # shell into container
docker compose stop                   # stop without losing data
docker compose down -v                # full reset (deletes DB)

⁠PHP extensions

curl imap xml gd bcmath mbstring zip pdo_mysql mysqli intl opcache apcu sockets

⁠Notes

• VTENext source is cloned from the official repo⁠ at build time
• Custom branch or tag: docker compose build --build-arg VTENEXT_BRANCH=<tag>
• Data persists across restarts via named Docker volumes
• For production: add HTTPS via Nginx reverse proxy + Let's Encrypt

Based on VTENext CE — https://github.com/VTECRM/vtenext⁠