|
|
|
|
@ -0,0 +1,60 @@
|
|
|
|
|
# Matomo (formerly Piwik)
|
|
|
|
|
|
|
|
|
|
[](https://travis-ci.org/matomo-org/docker) [Matomo](https://matomo.org/) (formerly 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
|
|
|
|
|
|
|
|
|
|
%%LOGO%%
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
In keeping with a 'pure' micro-services approach, this image runs a Matomo service only (in the form of FastCGI). Because of that it **must** be used with companion containers which provide a database for data storage and HTTP to FastCGI proxy/translation services for the user interface.
|
|
|
|
|
|
|
|
|
|
## Runtime
|
|
|
|
|
|
|
|
|
|
You can run the Matomo container and service like so:
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
docker run -d --link some-mysql:db matomo
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
This assumes you've already launched a suitable MySQL or MariaDB database container.
|
|
|
|
|
|
|
|
|
|
You'll now need to use a suitable reverse proxy to access the user interface; which is available on TCP port 9000. Nginx provides the necessary functions for translation between HTTP and FastCGI.
|
|
|
|
|
|
|
|
|
|
## Matomo Installation
|
|
|
|
|
|
|
|
|
|
Once you're up and running, you'll arrive at the configuration wizard page. If you're using the compose file, 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.
|
|
|
|
|
|
|
|
|
|
## Docker-compose examples and log import instructions
|
|
|
|
|
|
|
|
|
|
A minimal set-up using docker-compose is available in the [.examples folder](https://github.com/matomo-org/docker/tree/master/.examples).
|
|
|
|
|
|
|
|
|
|
If you want to use the import logs script, you can then run the following container as needed, in order to execute the python import logs script:
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
docker run --rm --volumes-from="matomo_app_1" --link matomo_app_1 python:2-alpine python /var/www/html/misc/log-analytics/import_logs.py --url=http://ip.of.your.piwik --login=yourlogin --password=yourpassword --idsite=1 --recorders=4 /var/www/html/logs/access.log
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Contribute
|
|
|
|
|
|
|
|
|
|
Pull requests are very welcome!
|
|
|
|
|
|
|
|
|
|
We'd love to hear your feedback and suggestions in the issue tracker: [github.com/motomo-org/docker/issues](https://github.com/matomo-org/docker/issues).
|
|
|
|
|
|
|
|
|
|
## GeoIP
|
|
|
|
|
|
|
|
|
|
This product includes GeoLite data created by MaxMind, available from [http://www.maxmind.com](http://www.maxmind.com).
|