forked from Wavyzz/dolibarr-docker
ce9d9c483c
* Add some example of integrations Update docker-run.sh to deal with docker secret for some vars. * Update update.sh Fix review * Update .gitignore
85 lines
3.8 KiB
Plaintext
85 lines
3.8 KiB
Plaintext
# Dolibarr on Docker
|
|
|
|
Docker image for Dolibarr with auto installer on first boot.
|
|
|
|
## Supported tags
|
|
%TAGS%
|
|
|
|
## What is Dolibarr ?
|
|
|
|
Dolibarr ERP & CRM is a modern software package to manage your organization's activity (contacts, suppliers, invoices, orders, stocks, agenda, ...).
|
|
|
|
> [More information](https://github.com/dolibarr/dolibarr)
|
|
|
|
## How to run this image ?
|
|
|
|
This image is based on the [official PHP repository](https://registry.hub.docker.com/_/php/).
|
|
|
|
**Important**: This image don't contains database. So you need to link it with a database container.
|
|
|
|
Let's use [Docker Compose](https://docs.docker.com/compose/) to integrate it with [MariaDB](https://hub.docker.com/_/mariadb/) (you can also use [MySQL](https://hub.docker.com/_/mysql/) if you prefer).
|
|
|
|
Create `docker-compose.yml` file as following:
|
|
|
|
```yaml
|
|
version: "3"
|
|
|
|
services:
|
|
mariadb:
|
|
image: mariadb:latest
|
|
environment:
|
|
MYSQL_ROOT_PASSWORD: root
|
|
MYSQL_DATABASE: dolibarr
|
|
|
|
web:
|
|
image: tuxgasy/dolibarr
|
|
environment:
|
|
DOLI_DB_HOST: mariadb
|
|
DOLI_DB_USER: root
|
|
DOLI_DB_PASSWORD: root
|
|
DOLI_DB_NAME: dolibarr
|
|
DOLI_URL_ROOT: 'http://0.0.0.0'
|
|
PHP_INI_DATE_TIMEZONE: 'Europe/Paris'
|
|
ports:
|
|
- "80:80"
|
|
links:
|
|
- mariadb
|
|
```
|
|
|
|
Then run all services `docker-compose up -d`. Now, go to http://0.0.0.0 to access to the new Dolibarr installation.
|
|
|
|
### Other examples
|
|
|
|
You can find several examples in the `examples` directory, such as:
|
|
- [Running Dolibarr with a mysql server](./examples/with-mysql/dolibarr-with-mysql.md)
|
|
- [Running Dolibarr with a Traefik reverse proxy](./examples/with-rp-traefik/dolibarr-with-traefik.md)
|
|
- [Running Dolibarr with secrets](./examples/with-secrets/dolibarr-with-secrets.md)
|
|
|
|
## Upgrading version and migrating DB
|
|
Remove the `install.lock` file and start an updated version container. Ensure that env `DOLI_INSTALL_AUTO` is set to `1`. It will migrate Database to the new version.
|
|
|
|
## Environment variables summary
|
|
|
|
| Variable | Default value | Description |
|
|
| ----------------------------- | ------------------ | ----------- |
|
|
| **DOLI_INSTALL_AUTO** | *1* | 1: The installation will be executed on first boot
|
|
| **DOLI_DB_HOST** | *mysql* | Host name of the MariaDB/MySQL server
|
|
| **DOLI_DB_HOST_PORT** | *3306* | Host port of the MariaDB/MySQL server
|
|
| **DOLI_DB_USER** | *doli* | Database user
|
|
| **DOLI_DB_PASSWORD** | *doli_pass* | Database user's password
|
|
| **DOLI_DB_NAME** | *dolidb* | Database name
|
|
| **DOLI_ADMIN_LOGIN** | *admin* | Admin's login create on the first boot
|
|
| **DOLI_ADMIN_PASSWORD** | *admin* | Admin's password
|
|
| **DOLI_URL_ROOT** | *http://localhost* | Url root of the Dolibarr installation
|
|
| **PHP_INI_DATE_TIMEZONE** | *UTC* | Default timezone on PHP
|
|
| **PHP_INI_MEMORY_LIMIT** | *256M* | PHP Memory limit
|
|
| **WWW_USER_ID** | | ID of user www-data. ID will not changed if leave empty. During a development, it is very practical to put the same ID as the host user.
|
|
| **WWW_GROUP_ID** | | ID of group www-data. ID will not changed if leave empty.
|
|
|
|
Some environment variables are compatible with docker secrets behaviour, just add the `_FILE` suffix to var name and point the value file to read.
|
|
Environment variables that are compatible with docker secrets:
|
|
- `DOLI_DB_USER` => `DOLI_DB_USER_FILE`
|
|
- `DOLI_DB_PASSWORD` => `DOLI_DB_PASSWORD_FILE`
|
|
- `DOLI_ADMIN_LOGIN` => `DOLI_ADMIN_LOGIN_FILE`
|
|
- `DOLI_ADMIN_PASSWORD` => `DOLI_ADMIN_PASSWORD_FILE`
|