Go to file
Thibault Francois 1ba7a2f475
Merge pull request #492 from thifranc/master
[fix] rather log %a [IP addr] than %h [HOSTNAME]
2021-10-26 09:41:04 +02:00
.tx
api API: instantiate m_message for logging 2021-02-25 16:48:45 -05:00
awstats
bureau Fixes #441: Correct DMARC entry syntax 2021-06-16 17:08:54 +02:00
debian
etc
install Fixes #441: Correct DMARC entry syntax 2021-06-16 17:08:54 +02:00
lang
lib/Alternc/Api
man DEBIAN COMPLIANCE big commit : fixes almost all lintian issues + complete rewrite of debian/rules (now mostly in Makefile at the root of source code) + start using POD2MAN for man pages + remove some old unused and broken tools 2013-04-23 15:11:00 +00:00
nightlybuild
phpunit
po
roundcube Remove last vestiges of alternc-roundcube user 2018-10-22 17:05:13 +02:00
selenium fixing alternc-awstats shell: using BASH 2014-03-28 16:05:36 +01:00
squirrelmail [fix] roundcube and squirrelmail are specific packages 2018-06-23 16:47:15 +02:00
src [fix] + fixperms should have a -h option and colors 2018-10-25 17:30:50 +02:00
stretch
tests Dataset 2012-08-25 14:45:55 +00:00
tools [fix] replacing /var/run by /run everywhere we can (not everywhere: postfix chroot or old compatibility is maintained 2018-07-04 17:42:42 +02:00
.gitattributes
.gitignore
.gitmodules
.scrutinizer.yml
.svnignore
.travis.yml
CODING_CONVENTION.php
COPYING AlternC Plugin are now part of AlternC svn repository\n Migration Phase 2 2006-04-26 12:28:53 +00:00
DEBIAN_COMPLIANCE [enh] debian compliance work, almost no warning in lintian 2018-06-24 17:18:01 +02:00
Makefile
README.md
repos-to-tx.sh [fix] UPDATE of PO Translations, Fixes #45 + repos-to-tx.sh doing that automatically, + update from transifex 2017-10-08 14:51:51 +02:00
tx-to-repos.sh

README.md

AlternC: Web and Email Hosting Software Suite

AlternC is a software helping system administrators to handle Web and Email services management. It should be easy to install, based only on free software.

This software consist of an automatic install and configuration system, a web control panel to manage hosted users and their web services such as domains, email accounts, ftp accounts, web statistics...

Technically, AlternC is based on Debian GNU/Linux distribution and it depends on other software such as Apache, Postfix, Dovecot, Mailman (...). It also contains an API documentation so that users can easily customize their web desktop.

This project native language is French, and the code is commented in English. The packages are available at least in French and English, German and Spanish interfaces are usually available too.

Installation

To install AlternC, please follow our install documentation

Pour installer AlternC, merci de suivre la documentation d'installation

Upgrading from AlternC 3.[1,2,3].11

AlternC >= 3.5 removes integrates alternc-ssl and alternc-admintools in the the core AlternC package.

As a result, both alternc-ssl and alternc-admintools will be removed during installation. When alternc-ssl is removed, it will mark many of the sub domain types suffixed with '-ssl' and '-mixssl' for deletion.

To safely upgrade between these versions:

  • Backup your AlternC database
  • Stop the cron service: /etc/init.d/cron stop
  • Install alternc (>= 3.5)
  • Run the following queries against the alternc database (here, it's called "alternc"): ``` mysql alternc -e 'update sub_domaines set web_action = "OK" where type like "%-mixssl";' mysql alternc -e 'update sub_domaines set web_action = "OK" where type like "%-ssl";'
* Run alternc.install
* Start the cron service again: ```/etc/init.d/cron start```

## Developper information

* This software is built around a Debian package for Stretch whose packaging instructions are located in [debian/](debian/) folder (this package can be installed on Jessie safely too)
* To **build the packages**, clone this repository in a Debian machine and use `debuild` or `dpkg-buildpackage` from source code root.

* The web control panel pages written in PHP are located in [bureau/admin](bureau/admin) and the associated PHP classes doing the stuff are in [bureau/class](bureau/class).

## Nightly build

We have 1 nightly build repositories:
* stretch - [stable 3.5](http://stable-3-5.nightly.alternc.org/)

and 3 nightly from former Debian releases (now unmaintained) 
* jessie - [stable 3.3](http://stable-3-3.nightly.alternc.org/)
* wheezy - [stable 3.2](http://stable-3-2.nightly.alternc.org/)
* squeeze - [stable 3.1](http://stable-3-1.nightly.alternc.org/)

To use one of them, create a file named `/etc/apt/sources.list.d/alternc-nightly-stable-3.5.list` (for debian Jessie or Stretch) as follow :

deb http://stable-3-5.nightly.alternc.org/ latest/


The repository and the packages are signed by the pgp key of AlternC nightly build user :

wget http://stable-3-5.nightly.alternc.org/nightly.key -O - | apt-key add -


## License

AlternC is distributed under the GPL v2 or later license. See `COPYING`.

AlternC's translations (po files) are distributed under the [Creative Commons CC0 license](https://creativecommons.org/publicdomain/zero/1.0/). Don't participate to the translation if you don't agree to publish your translations under that license.