iq-scm/mamute

Q&A Engine

Mamute QA

Requirements

This project makes use of the following technologies to simplify setup:

• Node.js
• npm
• Docker CE
• Docker Compose

How to set up an instance of Mamute

First of all, you need to setup an MySQL database. The default database name is mamute_development, the username is root and the password must be blank.

You may also use Docker Compose to run your MySQL database:

docker-compose -f docker-compose-it.yml up -d

This is useful for running the tests.

To use Mamute

Using docker-compose:

To start an instance of the latest Mamute release and its dependencies:

cd docker
docker-compose up --build

Then you can access Mamute on http://localhost:80.

Using a compiled war file:

1. Download the war of the latest version at http://www.mamute.org
2. Unpack it to a folder named yourproject/mamute
3. Run it by executing the bash script mamute/run.sh
4. If everything worked, you are free to customize mamute folder as you want to!

Using git + maven:

1. Clone the repository from github
2. Install node and npm
3. Run npm install
4. Run npm install -g grunt-cli
5. Run ./scripts/mvn-package.sh
6. Make a copy of mamute/target/mamute-1.0.0-SNAPSHOT to yourproject/mamute
7. Run it by executing the bash script mamute/run.sh
8. If everything worked, you are free to customize mamute folder as you want to!

To contribute with mamute:

1. Fork the repository from github
2. Clone the fork
3. Install node and npm
4. Run npm install
5. Run npm install -g grunt-cli
6. Run Main.java to start mamute
7. Develop and do your pull request

FAQ

• How to setup an instance

• How can I boot Mamute in a production environment?

• How can I configure ad banners in my site?

• How can I configure the system to activate/deactivate some feature?

• How can I configure the system to allow/disallow the creation of tags by common users?

• Is it possible to delete inappropriate questions?

• How can I update mamute in my project?

• What are the basic CSS classes to customize Mamute?

Questions?

Send your questions to mamute meta.

Or to our mail-list: [email protected]

Mamute was developed by www.caelum.com.br and www.alura.com.br developers