README.md 4.72 KB
Newer Older
1
# Mahara Readme
Nigel McNie committed
2

3
Mahara is an open source ePortfolio system. An ePortfolio is a type of
4 5
web application that allows users to record and share evidence of lifelong learning.

6
For more information about Mahara and ePortfolios, see the Mahara user manual's
7 8
introduction chapter:

9
 * http://manual.mahara.org/en/15.10/intro/introduction.html#what-is-mahara
10 11

# SUPPORT
12

13
The best ways of obtaining support are:
14

15 16
 * http://manual.mahara.org - the Mahara online user manual
 * https://mahara.org/forums - the Mahara project community forums
17
 * https://wiki.mahara.org - the Mahara wiki
18 19
 * #mahara on freenode (IRC) - live chat with other users and developers

20 21 22
# INSTALLATION

For detailed installation instructions, see the installation page on our wiki:
23

24
 * https://wiki.mahara.org/wiki/System_Administrator%27s_Guide/Installing_Mahara
Nigel McNie committed
25

26
The basic installation instructions are:
Nigel McNie committed
27

28 29 30 31 32 33 34
 1. Create a Postgres or MySQL database for Mahara.
 2. Copy the Mahara files under "htdocs" into your web root.
 3. Create a Mahara "dataroot" directory outside of your web root.
 4. Copy htdocs/config-dist.php to config.php.
 5. Edit config.php with the correct details for your installation.

# UPGRADING
35

36
Mahara 15.10 supports direct upgrades from previous Mahara versions 1.6.0 and later.
37
To upgrade an existing Mahara installation, follow the instructions here:
38

39
 * https://wiki.mahara.org/wiki/System_Administrator%27s_Guide/Upgrading_Mahara
40

41
# SYSTEM REQUIREMENTS
42

43
Here are the system requirements needed to run Mahara 15.10.
44

Aaron Wells committed
45
### OS
46

Aaron Wells committed
47 48 49
Mahara is only officially supported on Debian (5.0/"Lenny" or later) and
Ubuntu (10.04/"Lucid Lynx" or later), however it will probably run in any
OS with a suitable web server.
50

51 52
### Web Server

53
Mahara is only officially supported on Apache 2 or later, although it will
54 55
probably run in any web server with the proper PHP extensions.

Aaron Wells committed
56 57
### Database

58
Mahara requires either Postgres or MySQL. It would require extensive
Aaron Wells committed
59 60 61 62
modification to support other databases.
 * Postgres 8.3 or later
 * MySQL 5.1 or later (or MariaDB equivalent)

63 64
### PHP

Aaron Wells committed
65 66 67 68
Mahara requires PHP version 5.3 or later. The "magic_quotes" and "register_globals"
settings should be turned *off* (which is the default on modern PHP installations).

The following PHP extensions are also required:
69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
 * curl
 * gd (including Freetype support)
 * json
 * ldap
 * libxml
 * mbstring
 * mcrypt
 * mime_magic; or fileinfo
 * pgsql; or mysqli; or mysql
 * session
 * SimpleXML
 * bz2 (optional)
 * imagick (optional)
 * openssl and xmlrpc (optional; for networking support)
 * zlib (optional)
 * adodb (optional; improves performance)
 * enchant or pspell (optional; for TinyMCE spellcheck button)

### Web Browser

Mahara should be accessible in any modern web browser with
Javascript support. However, it is only actively tested in the most recent
91 92
versions of Firefox, Chrome, Safari, and Opera; and the Microsoft-supported
versions of Internet Explorer (IE). For Mahara 15.10, these versions are:
93 94 95 96
 * Firefox - 41.0
 * Chrome - 45.0
 * Safari - 8.0
 * Opera - 32.0
97 98 99 100 101
 * IE - 11 and Edge

Mahara will still work with Internet Explorer 10, but we recommend to use a
supported version of Internet Explorer or a different browser to have all
functionality available as well as all necessary security updates for the browser.
102 103 104

# TRANSLATIONS

105
Mahara has been translated into many languages. You can get language packs from:
106

Aaron Wells committed
107
* https://wiki.mahara.org/wiki/Language_Packs
108

109 110 111 112
# MOODLE

Documentation on integrating Mahara with Moodle can be found in the
3.1MB PDF here:
113

114
 * https://wiki.mahara.org/images/d/d5/Mahoodle.pdf
115

116 117
------------------
# Copyright notice
118

119
Copyright (C) 2006-2015 Catalyst IT and others; see:
Aaron Wells committed
120
https://wiki.mahara.org/wiki/Contributors
121 122 123

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
124
the Free Software Foundation, version 3 or later of the License.
125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Additional permission under GNU GPL version 3 section 7:

If you modify this program, or any covered work, by linking or
combining it with the OpenSSL project's OpenSSL library (or a
modified version of that library), containing parts covered by the
terms of the OpenSSL or SSLeay licenses, the Mahara copyright holders
grant you additional permission to convey the resulting work.
Corresponding Source for a non-source form of such a combination
shall include the source code for the parts of OpenSSL used as well
as that of the covered work.