README.md 2.63 KB
Newer Older
Michael Babker's avatar
Michael Babker committed
1
2
3
4
Docker Mautic Image
===================
# License

5
Mautic (and this Docker Recipe) is distributed under the GPL v3 license. Full details of the license can be found in the [Mautic GitHub repository](https://github.com/mautic/mautic/blob/staging/LICENSE.txt).
Michael Babker's avatar
Michael Babker committed
6

7
8


Michael Babker's avatar
Michael Babker committed
9
10
# How to use this image

11
12
These instructions might be useful to some, so I'm leaving them here, but I've written more comprehensive instructions on https://tech.oeru.org/installing-mautic-php7-fpm-docker-nginx-and-mariadb-ubuntu-1604

13
1. you need a Docker host configured to use both a current Docker and Docker Compose with network access and git installed.  
Michael Babker's avatar
Michael Babker committed
14

15
1. make sure you have a MySQL or MariaDB running either on your Docker host, or in a container
Michael Babker's avatar
Michael Babker committed
16

17
1. clone this repo:
18
19
`git clone git@github.com:oeru/docker-mautic.git`
which will, by default, create a directory called 'docker-mautic'
Michael Babker's avatar
Michael Babker committed
20

21
22
23
1. create a local docker-compose.yml by copying docker-compose.yml-sample:
`cd docker-mautic`
`cp docker-compose.yml-sample docker-compose.yml`
24
and the edit the file to specify the details of your MySQL or MariaDB database. You need to specify a user who has the ability to create a database. Also, if you're running an nginx container, you can tweak the ports assignments to make it publicly visible (I encourage defaulting to SSL!).
Dave Lane's avatar
Dave Lane committed
25
26
27

1. adjust the nginx "default.conf" (replace it with "ssl.conf" if you want to offer secure hosting!) and set up the path to your repo in the yml file so that the nginx container can find the conf file.

28
1. you also need to create a directory on your Docker host for your Mautic code, and reference it in the yml file.
Dave Lane's avatar
Dave Lane committed
29

30
31
1. then run
`docker-compose up`
Dave Lane's avatar
Dave Lane committed
32
33
34
35
36
to pull (if necessary) and run your mautic (and, if you're using it) your nginx container. If you're running it locally, access it via `http://localhost:8083` in a browser.

1. Run `docker-compose up`, wait for it to initialize completely, and visit `http://localhost:8080` or `http://host-ip:8080`.

# Running a MySQL/MariaDB container...
Michael Babker's avatar
Michael Babker committed
37

38
If you're running MySQL or MariaDB in another container, add another stanza to this yml file to describe it and link it with the mautic stanza!
Michael Babker's avatar
Michael Babker committed
39

40
41
    mautic:
	  image: kiwilightweight/mautic
Michael Babker's avatar
Michael Babker committed
42
43
44
	  links:
	    - mauticdb:mysql
	  ports:
45
46
47
48
49
	    - ...
    mauticdb:
	  image: mariadb

# Supported Docker versions
Michael Babker's avatar
Michael Babker committed
50

51
This has been tested on Docker 1.13.1 on Ubuntu Linux 16.04 and requires Docker 1.10.x or better.
Michael Babker's avatar
Michael Babker committed
52
53
54
55
56

# User Feedback

## Issues

57
If you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/oeru/docker-mautic/issues). We will endeavour to assist, although we're doing this through enlightened self-interest, so can't provide any guarantees!