Skip to content
Normal view History Permalink
README.md 1.87 KiB
Newer Older
Michel Memeteau's avatar
matomo  
Michel Memeteau committed
1 
# MATOMO
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
2 3 4 5 6 7 8 9 10 11 12 

[![Build Status](https://travis-ci.org/piwik/docker-piwik.svg?branch=master)](https://travis-ci.org/piwik/docker-piwik)

Piwik is the leading open-source analytics platform that gives you more than just powerful analytics:

 - Free open-source software
 - 100% data ownership
 - User privacy protection
 - User-centric insights
 - Customisable and extensible
Michel Memeteau's avatar
matomo  
Michel Memeteau committed
13 
![logo](https://static.matomo.org/wp-content/uploads/2018/10/matomo-logo-final-1-170x25.png)
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
14
Michel Memeteau's avatar
Update README.md  
Michel Memeteau committed
15 
# How to use this recipe
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
16
Michel Memeteau's avatar
Update README.md  
Michel Memeteau committed
17 
The easiest is to use with `libre.sh`.
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
18
Michel Memeteau's avatar
Update README.md  
Michel Memeteau committed
19 
Make sure you have [libresh](https://libre.sh) installed. And then:
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
20 21 

```bash
Michel Memeteau's avatar
Update README.md  
Michel Memeteau committed
22 
libre provision -a matomo -u matomo.local -s
Michel Memeteau's avatar
matomo  
Michel Memeteau committed
23
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
24 25 26 27 28 29 
```

You can now access your instance on the port 80 of the IP of your machine (not recommended for production).

## Access it from Internet
Pierre Ozoux's avatar
consistency  
Pierre Ozoux committed
30 
We recommend the usage of TLS, so the easiest is to use a TLS capable reverse proxy.
Pierre Ozoux's avatar
gives some :heart:  
Pierre Ozoux committed
31 
Here are 2 examples:
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
32
Pierre Ozoux's avatar
gives some :heart:  
Pierre Ozoux committed
33 34 
 - [haproxy](https://github.com/indiehosters/haproxy)
 - [nginx](https://github.com/indiehosters/nginx)
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
35
Pierre Ozoux's avatar
gives some :heart:  
Pierre Ozoux committed
36 
You can also modify manually the nginx configuration file and map the TLS port of the host to the container.
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 

## Installation

Once started, you'll arrive at the configuration wizard.
At the `Database Setup` step, please enter the following:

  -  Database Server: `db`
  -  Login: `root`
  -  Password: MYSQL_ROOT_PASSWORD
  -  Database Name: piwik (or you can choose)
 
And leave the rest as default.

Then you can continue the installation with the super user.

## Backup
Pierre Ozoux's avatar
gives some :heart:  
Pierre Ozoux committed
54 
In order to backup, just run the `./pre-backup` script. And copy all the data to a safe place.
Pierre Ozoux's avatar
Moves compose here  
Pierre Ozoux committed
55 56 57 58 59 60 61 62 63 64 65 

## Contribute

Pull requests are very welcome!

We'd love to hear your feedback and suggestions in the issue tracker: [github.com/indiehosters/piwik/issues](https://github.com/indiehosters/piwik/issues).

## GeoIP

This product includes GeoLite data created by MaxMind, available from
[http://www.maxmind.com](http://www.maxmind.com).