One-Click Installation

Zammad Initialization:

Overview:

This guide will walk you through initializing Zammad on your AWS instance in just one click. The setup process is streamlined using our custom script, designed for ease of use and efficiency. Before starting the script, ensure the minimum requirement is met.

Pro Tip: We recommend associating an AWS Elastic IP with your instance before running the setup. This prevents your IP address from changing when the instance is stopped and restarted.

Step 1: Access Your AWS Instance

1. Launch Your AWS EC2 Instance:

• Choose your desired AWS EC2 instance type. (Recommended: t3a.small / t3.small)
• Once the instance is running, connect to it via SSH.

2. Connect to the Instance:

• Open your terminal (Mac/Linux) or use an SSH client (e.g., PuTTY for Windows).
• Run the following SSH command:

• When prompted for the login, enter:
  

3. Run the Initialization Script:

• To initiate the installation, run the following command:

• Note: This script automates the entire installation process. While it runs, ensure your terminal remains active, and do not close the session. The script may take up to 10-20 seconds to complete. The script will random generate new credentials for all the necessity.

Step 2: Instance Set Up and Installation 

1. Completion Confirmation:

• Once the installation is finished, you will see a summary on the screen that includes all credentials.

2. Access the Web Interface:

• Open your web browser and navigate to http://<your-public-ip> :

• You will be greeted by Zammad welcome screen. Click “Set up a new system” to proceed with installation.

Step 3: Finalizing Installation  

1. Administrator Account:

• Fill up all fields accordingly as per your business needs. Click “Create” to proceed when done.
• Take note of the email and password as you will use them to log into Zammad panel.

2. Organization:

• Fill up all fields accordingly as per your business needs.
• System URL: <your public ip> (auto detected, you may leave it as default).   
• Click “Next” to proceed.

3. Email Notification:

• You may choose “Local MTA” or “SMTP“.
• If you choose “Local MTA” you may need to contact (send them a ticket) AWS to allow SMTP port. By default it is barred, unless otherwise requested to be lifted. Our advice is to “SMTP” setting to configure your own outgoing SMTP setting.
• Alternatively, you may click “Skip” and perform the setting later in Zammad panel. When inside the panel, go to Settings > Channels > Email then look for Outbound.

4. Connect Channels:

• You may click “Email” to fill up the channel. Or press “Skip” to set them inside Zammad panel.

5. Dashboard:

• Congratulations! You have successfully installed and logged into Zammad.

Important Notes:

• Mail Sending Blockage:
  AWS may have email-sending restrictions in place by default. Before using the instance for email sending, submit a request to AWS to lift the restriction on outbound email traffic.