Console¶
Zammad uses Ruby on Rails so you can make use of the rails console.
Warning
Please double check your commands before running, as some of those commands might cause data loss or damaged tickets! If you’re unsure, use a test system first!
To open the rails console on the shell you have to enter the following commands.
Start Zammad’s Rails console¶
Running a single command¶
The following command will allow you to run a single command, without running a shell (e.g. for automation).
Note
Replace {COMMAND}
with your command you want to run.
Tip
If you enter a p
in front of your command
(e.g. like rails r 'p Delayed::Job.count'
),
you’ll actually receive a printed output (without you won’t!).
# package installation
$ zammad run rails r '{COMMAND}'
# source installation
$ rails r '{COMMAND}'
Running several commands in a shell¶
The following command will provide you a rails console. It allows you to run several commands inside it.
This reduces loading times greatly.
# package installation
$ zammad run rails c
# source installation
$ rails c
Hint
Starting Rails Console in Safe Mode
Normally, starting rails console requires certain third-party services to be up and running. You may receive errors and console will refuse to start in case they are not available.
However, it’s possible to start rails console in safe mode by setting
a special environment variable. With
ZAMMAD_SAFE_MODE=1
set, availability of these services will be ignored.
$ ZAMMAD_SAFE_MODE=1 zammad run rails c
Zammad is running in safe mode. Any third-party services like Redis are ignored.
There was an error trying to connect to Redis via redis://localhost:6379.
Please provide a Redis instance at localhost:6379 or set REDIS_URL to point to a different location.
#<Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)>
Loading production environment (Rails 6.1.7.3)
3.1.3 :001 >
$ ZAMMAD_SAFE_MODE=1 rails c
Zammad is running in safe mode. Any third-party services like Redis are ignored.
There was an error trying to connect to Redis via redis://localhost:6379.
Please provide a Redis instance at localhost:6379 or set REDIS_URL to point to a different location.
#<Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)>
Loading production environment (Rails 6.1.7.3)
3.1.3 :001 >
Working on the console¶
Here’s a topic list for quick jumping and better overview.
- Query and set / update Zammad settings
- Advanced customization settings
- Send all outgoing E-Mails to a BCC-Mailbox
- Activate counter on grouped overviews
- Default ticket type on creation
- Adding a warning to the ticket creation process
- Adding a warning to the article reply process
- Show Email address of customer on customer selection (ticket creation)
- Change font settings for outgoing HTML mails
- Highlight customer’s open ticket count
- Working on user information
- Working with ticket information
- Working with ticket articles
- Working with groups
- Working with chat logs
- Other Useful Commands
- Deleting records