2013-01-21 19:24:41 +00:00
|
|
|
Welcome to Zammad
|
|
|
|
=================
|
2012-04-10 13:31:05 +00:00
|
|
|
|
|
|
|
Zammad is a web based open source helpdesk/ticket system with many features
|
2016-08-17 11:24:51 +00:00
|
|
|
to manage customer communication via several channels like telephone, facebook,
|
|
|
|
twitter, chat and e-mails. It is distributed under the GNU AFFERO General Public
|
|
|
|
License (AGPL) and tested on Linux, Solaris, AIX, FreeBSD, OpenBSD and Mac OS
|
|
|
|
10.x. Do you receive many e-mails and want to answer them with a team of agents?
|
|
|
|
You're going to love Zammad!
|
2012-04-10 13:31:05 +00:00
|
|
|
|
2013-01-08 11:58:58 +00:00
|
|
|
|
2013-01-21 19:24:41 +00:00
|
|
|
Getting Started
|
|
|
|
---------------
|
2012-04-10 13:31:05 +00:00
|
|
|
|
|
|
|
1. Install Zammad on your system
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2016-10-06 16:57:04 +00:00
|
|
|
root@shell> cd /opt/
|
|
|
|
root@shell> tar -xzf zammad-1.0.1.tar.gz
|
|
|
|
root@shell> useradd zammad
|
|
|
|
zammad@shell> su - zammad
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2012-04-10 13:31:05 +00:00
|
|
|
|
|
|
|
2. Install all dependencies
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2016-10-06 16:57:04 +00:00
|
|
|
zammad@shell> cd zammad
|
|
|
|
zammad@shell> gem install bundler
|
2016-08-30 10:00:04 +00:00
|
|
|
|
2016-10-06 16:57:04 +00:00
|
|
|
# For PostgreSQL (note, the option says "without ... mysql")
|
|
|
|
zammad@shell> bundle install --without test development mysql
|
2016-08-30 10:00:04 +00:00
|
|
|
|
2016-10-06 16:57:04 +00:00
|
|
|
# For MySQL (note, the option says "without ... postgres")
|
|
|
|
zammad@shell> bundle install --without test development postgres
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2012-04-10 13:31:05 +00:00
|
|
|
|
2013-01-22 20:18:40 +00:00
|
|
|
3. Configure your databases
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2016-10-06 16:57:04 +00:00
|
|
|
zammad@shell> cp config/database.yml.dist config/database.yml
|
|
|
|
zammad@shell> vi config/database.yml
|
2013-01-22 20:18:40 +00:00
|
|
|
```
|
2012-04-10 13:31:05 +00:00
|
|
|
|
2012-04-11 11:30:26 +00:00
|
|
|
4. Initialize your database
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2016-10-06 16:57:04 +00:00
|
|
|
zammad@shell> export RAILS_ENV=production
|
|
|
|
zammad@shell> rake db:create
|
|
|
|
zammad@shell> rake db:migrate
|
|
|
|
zammad@shell> rake db:seed
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
|
|
|
|
2016-10-06 16:57:04 +00:00
|
|
|
5. Change directory to zammad (if needed) and start the web server:
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2016-10-06 16:57:04 +00:00
|
|
|
zammad@shell> rake assets:precompile
|
|
|
|
zammad@shell> rails s -p 3000 # application web server
|
|
|
|
zammad@shell> script/websocket-server.rb start # non blocking websocket server
|
|
|
|
zammad@shell> script/scheduler.rb start # generate overviews on demand, just send changed data to browser
|
2013-01-21 19:24:41 +00:00
|
|
|
```
|
2012-04-10 13:31:05 +00:00
|
|
|
|
2013-01-08 11:58:58 +00:00
|
|
|
6. Go to http://localhost:3000/#getting_started and you'll see:
|
2016-10-06 16:57:04 +00:00
|
|
|
"Welcome to Zammad!", there you need to create your admin user and you need to invite other agents.
|