2017-10-13 12:07:50 +02:00
|
|
|
# Evoadmin mail
|
|
|
|
|
2018-01-28 19:53:14 +01:00
|
|
|
Evoadmin mail is a Web Interface for manage an LDAP directory designed for mail accounts.
|
2017-10-13 12:07:50 +02:00
|
|
|
|
2018-03-08 13:04:50 +01:00
|
|
|
## Install
|
2017-10-13 12:07:50 +02:00
|
|
|
|
2018-11-21 16:38:17 +01:00
|
|
|
Evoadmin-mail requirements are an LDAP server, a Web server and PHP. See [INSTALL](docs/install.md) for configure them.
|
|
|
|
|
|
|
|
Multiples services can be configured to use the LDAP directory managed by Evoadmin-mail :
|
|
|
|
|
|
|
|
- TODO
|
2017-10-13 12:07:50 +02:00
|
|
|
|
2018-03-08 13:04:50 +01:00
|
|
|
## Test
|
|
|
|
|
|
|
|
You can deploy a test environmment with Vagrant :
|
|
|
|
|
|
|
|
~~~
|
|
|
|
vagrant up
|
|
|
|
~~~
|
|
|
|
|
2018-11-09 13:40:05 +01:00
|
|
|
Evoadmin mail respond to evoadminmail.packmail.example.com domain on localhost, so update your /etc/hosts :
|
2018-03-08 13:04:50 +01:00
|
|
|
|
|
|
|
~~~
|
2018-11-09 13:40:05 +01:00
|
|
|
127.0.0.1 evoadminmail.packmail.example.com
|
2018-03-08 13:04:50 +01:00
|
|
|
~~~
|
|
|
|
|
2018-11-09 13:40:05 +01:00
|
|
|
Congratulation, Evoadmin mail is now accessible throught https://evoadminmail.packmail.example.com:8443
|
2018-03-08 13:04:50 +01:00
|
|
|
|
|
|
|
### Authentication
|
|
|
|
|
|
|
|
Default admin user is "evoadmin", password is randomly generated and can be recovered from LDAP :
|
|
|
|
|
|
|
|
~~~
|
|
|
|
vagrant ssh
|
|
|
|
sudo -i
|
|
|
|
ldapvi --ldapsearch "(uid=evoadmin)" | grep userPassword | awk '{ print $2 }'
|
|
|
|
~~~
|
|
|
|
|
|
|
|
### Deployment
|
|
|
|
|
|
|
|
Launch rsync-auto in a terminal for automatic synchronisation of your local code with Vagrant VM :
|
|
|
|
|
|
|
|
~~~
|
|
|
|
vagrant rsync-auto
|
|
|
|
~~~
|
|
|
|
|
|
|
|
## License
|
2017-10-13 12:07:50 +02:00
|
|
|
|
2018-09-13 17:57:39 +02:00
|
|
|
This project is an [Evolix](https://evolix.com) project and is licensed under AGPLv3, see the [LICENSE](LICENSE) file for details.
|
2017-10-13 12:07:50 +02:00
|
|
|
|
2017-10-17 17:41:40 +02:00
|
|
|
Evolix trademark and logo are not freely reusable and are protected by copyright.
|