Virtuemart is a full-feature e-Commerce suite, which relies on and needs to be installed inside Joomla. For further information see http://www.virtuemart.net/
Virtuemart is a full-feature e-Commerce suite, which relies on and needs to be installed inside Joomla. For further information see http://www.virtuemart.net/
# About this image and its requirements
### Virtuemart 3.x on Joomla 2.5.28 (Full installer)
The stock VirtueMart full installer provides a pre-configured Joomla 2.5.28 installation with sample data installed and the front end already set up with the cart, category and product pages. You can install it from the `opentools/docker-virtuemart:fullinstaller` tag (this assumes an existing mysql container for the database to be linked):
```console
$docker run --name some-virtuemart --link some-mysql:mysql -d\
This will set up the database and the joomla/virtuemart files, but will leave the installation to you. Simply go to http://localhost:8080/ to run the installer. Unless you changed the defaults with the env variables listed above, the database credentials are:
- database host: mysql
- database: virtuemart
- database user: root
- database password: (the MYSQL_ROOT_PASSWORD given when the mysql container was created)
The Joomla installer will already be prefilled with these values (or the ones you gave in the environment variables).
### Virtuemart 3.x on Joomla 3.x (automated installation)
There is no full installer for VirtueMart 3.x on Joomla 3.x, so this image installed Joomla 3.x and then the Virtuemart 3.x packages, which provide sample data, but do not set up the Joomla front end with the cart, category and product menus and pages. The installation of Joomla and Virtuemart can mostly be done automatically, so in this case, there is no need to go through the installer. However, to configure Joomla, you can give the database prefix, the site name, the admin user/password etc. as env variables when the container is created:
A typical installation of Joomla 3.x with VirtueMart 3.x will thus use a docker line like:
```console
$docker run --name=some-virtuemart -eJOOMLA_DB_NAME=joomla_j3vm3 \
Available env variables are: `JOOMLA_ADMIN_USER`, `JOOMLA_ADMIN_PASSWORD`, `JOOMLA_ADMIN_EMAIL`, `JOOMLA_SITE_NAME`, `JOOMLA_DB_PREFIX`.
Joomla and Virtuemart itself can be set up automatically, but for technical reasons (Joomla does not have a clean separation of installation and GUI features), the Virtuemart EXT AIO cannot be installed automatically. So after installation, you need to go to Joomla's backend extensions page
and install the Virtuemart EXT AIO package from the folder
```
/usr/src/virtuemart/com_virtumart_ext_aio/
```
### Virtuemart 2.6 on Joomla 2.5 (Full installer)
The stock VirtueMart full installer of the (outdated) Virtuemart 2.6 provides a pre-configured Joomla 2.5.27 installation with sample data installed and the front end already set up with the cart, category and product pages. You can install it from the `opentools/docker-virtuemart:fullinstaller` tag (this assumes an existing mysql container for the database to be linked):
```console
$ docker run --name some-virtuemart --link some-mysql:mysql -d \
-p 8080:80 opentools/docker-virtuemart:j2vm2_full
```
This will set up the database and the joomla/virtuemart files, but will leave the installation to you. Simply go to http://localhost:8080/ to run the installer. Unless you changed the defaults with the env variables listed above, the database credentials are:
- database host: mysql
- database: j2vm2
- database user: root
- database password: (the MYSQL_ROOT_PASSWORD given when the mysql container was created)
### About this image and its requirements
This docker image provides the stock VirtueMart installation. There are tags for the full installer (which includes Joomla 2.5.28 and Virtuemart 3.x including sample products) and for a Joomla 3 installation (latest Joomla with Virtuemart 3.x, no sample products will be set up).
This docker image provides the stock VirtueMart installation. There are tags for the full installer (which includes Joomla 2.5.28 and Virtuemart 3.x including sample products) and for a Joomla 3 installation (latest Joomla with Virtuemart 3.x, no sample products will be set up).
Unless you configure the image differently, the MySQL database connection to the linked mysql contaner will be:
Unless you configure the image differently, the MySQL database connection to the linked mysql contaner will be:
...
@@ -22,15 +76,18 @@ This mysql container can then be linked to the virtuemart container as described
...
@@ -22,15 +76,18 @@ This mysql container can then be linked to the virtuemart container as described
# Which tags / variants are available for this image?
# Which tags / variants are available for this image?
-`opentools/docker-virtuemart:fullinstall` ... The stock fullinstaller provided by the VirtueMart Team (Joomla 2.5.28, Virtuemart 3.0.10). Automatic installation not possible, but the joomla installer will be run when you point your webbrowser to this container (see below).
- `opentools/docker-virtuemart:fullinstaller` ... The stock fullinstaller provided by the VirtueMart Team (Joomla 2.5.28, Virtuemart 3.0.10). Automatic installation not possible, but the joomla installer will be run when you point your webbrowser to this container (see below).
- `opentools/docker-virtuemart:j3vm3` ... Joomla 3 installation with Virtuemart 3.x. Automatic installation of Joomla and VirtueMart is attempted, admin username, password, email etc. are passed as env variables (see below)
- `opentools/docker-virtuemart:j3vm3` ... Joomla 3 installation with Virtuemart 3.x. Automatic installation of Joomla and VirtueMart is attempted, admin username, password, email etc. are passed as env variables (see below)
# How to use this image
- `opentools/docker-virtuemart:j2vm2_full` ... The stock fullinstaller provided by the VirtueMart Team with VirtueMart 2.x (Joomla 2.5.28, Virtuemart 2.6). Automatic installation not possible, but the joomla installer will be run when you point your webbrowser to this container (see below).
### How to use this image
```console
```console
$ docker run --name some-virtuemart --link some-mysql:mysql -d opentools/virtuemart:tag
$ docker run --name some-virtuemart --link some-mysql:mysql -d opentools/virtuemart:tag
```
```
where `tag` is either `fullinstall` (for the VM 3.0.10 full installer on Joomla 2.5.28, including sample data) or`j3vm3` for an automatic installation of VM 3.0.10 on Joomla 3.x (but no sample data).
where `tag` is either `fullinstaller` (for the VM 3.0.10 full installer on Joomla 2.5.28, including sample data), `j3vm3` for an automatic installation of VM 3.0.10 on Joomla 3.x (but no sample data) or `j2vm2_full` for VirtueMart 2.x on Joomla 2.5 (fullinstaller).
The following environment variables are also honored for configuring your Joomla instance:
The following environment variables are also honored for configuring your Joomla instance:
# Virtuemart 3.x on Joomla 2.5.28 (Full installer)
### Sources
The stock VirtueMart full installer provides a pre-configured Joomla 2.5.28 installation with sample data installed and the front end already set up with the cart, category and product pages. You can install it from the `opentools/docker-virtuemart:fullinstaller` tag:
```console
$docker run --name some-virtuemart --link some-mysql:mysql -d\
-p 8080:80 opentools/virtuemart:fullinstaller
```
This will set up the database and the joomla/virtuemart files, but will leave the installation to you. Simply go to http://localhost:8080/ to run the installer. Unless you changed the defaults with the env variables listed above, the database credentials are:
- database host: mysql
- database: virtuemart
- database user: root
- database password: (the MYSQL_ROOT_PASSWORD given when the mysql container was created)
# Virtuemart 3.x on Joomla 3.x (automated installation)
There is no full installer for VirtueMart 3.x on Joomla 3.x, so this image installed Joomla 3.x and then the Virtuemart 3.x packages, which provide sample data, but do not set up the Joomla front end with the cart, category and product menus and pages. The installation of Joomla and Virtuemart can mostly be done automatically, so in this case, there is no need to go through the installer. However, to configure Joomla, you can give the database prefix, the site name, the admin user/password etc. as env variables when the container is created:
A typical installation of Joomla 3.x with VirtueMart 3.x will thus use a docker line like:
Available env variables are: `JOOMLA_ADMIN_USER`, `JOOMLA_ADMIN_PASSWORD`, `JOOMLA_ADMIN_EMAIL`, `JOOMLA_SITE_NAME`, `JOOMLA_DB_PREFIX`.
Joomla and Virtuemart itself can be set up automatically, but for technical reasons (Joomla does not have a clean separation of installation and GUI features), the Virtuemart EXT AIO cannot be installed automatically. So after installation, you need to go to Joomla's backend extensions page