AfterLogic WebMail Installation Guide Installation Guide

AfterLogic WebMail is a free and open-source Webmail. Fast and easy-to-use webmail front-end

Hardware Requirements:

CPU: 2 cores minimum (4+ cores recommended)

RAM: 2GB minimum (4GB+ recommended)

Storage: 1GB for installation

Network: 80/443 ports

Operating System:

Linux: Any modern distribution (RHEL, Debian, Ubuntu, CentOS, Fedora, Arch, Alpine, openSUSE)

macOS: 10.14+ (Mojave or newer)

Windows: Windows Server 2016+ or Windows 10

FreeBSD: 11.0+

Network Requirements:

Port 80/443 (default afterlogic-webmail port)

Dependencies:

php, php-xml, php-dom

System Access: root or sudo privileges required

This guide supports installation on:

RHEL 8/9 and derivatives (CentOS Stream, Rocky Linux, AlmaLinux)

Debian 11/12

Ubuntu 20.04/22.04/24.04 LTS

Arch Linux (rolling release)

Alpine Linux 3.18+

openSUSE Leap 15.5+ / Tumbleweed

SUSE Linux Enterprise Server (SLES) 15+

macOS 12+ (Monterey and later)

FreeBSD 13+

Windows 10/11/Server 2019+ (where applicable)

bash

# Install EPEL repository if needed
sudo dnf install -y epel-release

# Install afterlogic-webmail
sudo dnf install -y afterlogic-webmail php, php-xml, php-dom

# Enable and start service
sudo systemctl enable --now httpd

# Configure firewall
sudo firewall-cmd --permanent --add-service=afterlogic-webmail
sudo firewall-cmd --reload

# Verify installation
afterlogic-webmail --version || systemctl status httpd

bash

# Update package index
sudo apt update

# Install afterlogic-webmail
sudo apt install -y afterlogic-webmail php, php-xml, php-dom

# Enable and start service
sudo systemctl enable --now httpd

# Configure firewall
sudo ufw allow 80/443

# Verify installation
afterlogic-webmail --version || systemctl status httpd

bash

# Install afterlogic-webmail
sudo pacman -S afterlogic-webmail

# Enable and start service
sudo systemctl enable --now httpd

# Verify installation
afterlogic-webmail --version || systemctl status httpd

bash

# Install afterlogic-webmail
apk add --no-cache afterlogic-webmail

# Enable and start service
rc-update add httpd default
rc-service httpd start

# Verify installation
afterlogic-webmail --version || rc-service httpd status

bash

# Install afterlogic-webmail
sudo zypper install -y afterlogic-webmail php, php-xml, php-dom

# Enable and start service
sudo systemctl enable --now httpd

# Configure firewall
sudo firewall-cmd --permanent --add-service=afterlogic-webmail
sudo firewall-cmd --reload

# Verify installation
afterlogic-webmail --version || systemctl status httpd

bash

# Using Homebrew
brew install afterlogic-webmail

# Start service
brew services start afterlogic-webmail

# Verify installation
afterlogic-webmail --version

bash

# Using pkg
pkg install afterlogic-webmail

# Enable in rc.conf
echo 'httpd_enable="YES"' >> /etc/rc.conf

# Start service
service httpd start

# Verify installation
afterlogic-webmail --version || service httpd status

powershell

# Using Chocolatey
choco install afterlogic-webmail

# Or using Scoop
scoop install afterlogic-webmail

# Verify installation
afterlogic-webmail --version

bash

# Create configuration directory if needed
sudo mkdir -p /var/www/afterlogic/data

# Set up basic configuration
sudo tee /var/www/afterlogic/data/afterlogic-webmail.conf << 'EOF'
# AfterLogic WebMail Configuration
EnableCaching = true
EOF

# Test configuration
sudo afterlogic-webmail -t || sudo httpd configtest

# Reload service
sudo systemctl reload httpd

bash

# Set appropriate permissions
sudo chown -R afterlogic-webmail:afterlogic-webmail /var/www/afterlogic/data
sudo chmod 750 /var/www/afterlogic/data

# Enable security features
# See security section for detailed hardening steps

bash

# Enable service
sudo systemctl enable httpd

# Start service
sudo systemctl start httpd

# Stop service
sudo systemctl stop httpd

# Restart service
sudo systemctl restart httpd

# Reload configuration
sudo systemctl reload httpd

# Check status
sudo systemctl status httpd

# View logs
sudo journalctl -u httpd -f

bash

# Enable service
rc-update add httpd default

# Start service
rc-service httpd start

# Stop service
rc-service httpd stop

# Restart service
rc-service httpd restart

# Check status
rc-service httpd status

bash

# Enable in /etc/rc.conf
echo 'httpd_enable="YES"' >> /etc/rc.conf

# Start service
service httpd start

# Stop service
service httpd stop

# Restart service
service httpd restart

# Check status
service httpd status

bash

# Using Homebrew services
brew services start afterlogic-webmail
brew services stop afterlogic-webmail
brew services restart afterlogic-webmail

# Check status
brew services list | grep afterlogic-webmail

powershell

# Start service
net start httpd

# Stop service
net stop httpd

# Using PowerShell
Start-Service httpd
Stop-Service httpd
Restart-Service httpd

# Check status
Get-Service httpd

bash

# Configure performance settings
cat >> /var/www/afterlogic/data/afterlogic-webmail.conf << 'EOF'
EnableCaching = true
EOF

# Apply system tuning
sudo sysctl -w net.core.somaxconn=65535
sudo sysctl -w net.ipv4.tcp_max_syn_backlog=65535

# Restart service
sudo systemctl restart httpd

bash

# Configure clustering (if supported)
# See official documentation for cluster setup

# Basic load balancing setup example
# Configure multiple instances on different ports

nginx

upstream afterlogic-webmail_backend {
    server 127.0.0.1:80/443;
    server 127.0.0.1:{default_port}1 backup;
}

server {
    listen 80;
    server_name afterlogic-webmail.example.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name afterlogic-webmail.example.com;

    ssl_certificate /etc/ssl/certs/afterlogic-webmail.example.com.crt;
    ssl_certificate_key /etc/ssl/private/afterlogic-webmail.example.com.key;

    location / {
        proxy_pass http://afterlogic-webmail_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket support (if needed)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

apache

<VirtualHost *:80>
    ServerName afterlogic-webmail.example.com
    Redirect permanent / https://afterlogic-webmail.example.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName afterlogic-webmail.example.com
    
    SSLEngine on
    SSLCertificateFile /etc/ssl/certs/afterlogic-webmail.example.com.crt
    SSLCertificateKeyFile /etc/ssl/private/afterlogic-webmail.example.com.key
    
    ProxyRequests Off
    ProxyPreserveHost On
    
    ProxyPass / http://127.0.0.1:80/443/
    ProxyPassReverse / http://127.0.0.1:80/443/
    
    # WebSocket support (if needed)
    RewriteEngine on
    RewriteCond %{HTTP:Upgrade} websocket [NC]
    RewriteCond %{HTTP:Connection} upgrade [NC]
    RewriteRule ^/?(.*) "ws://127.0.0.1:80/443/$1" [P,L]
</VirtualHost>

haproxy

frontend afterlogic-webmail_frontend
    bind *:80
    bind *:443 ssl crt /etc/ssl/certs/afterlogic-webmail.pem
    redirect scheme https if !{ ssl_fc }
    default_backend afterlogic-webmail_backend

backend afterlogic-webmail_backend
    balance roundrobin
    option httpchk GET /health
    server afterlogic-webmail1 127.0.0.1:80/443 check
    server afterlogic-webmail2 127.0.0.1:{default_port}1 check backup

bash

# Set appropriate permissions
sudo chown -R afterlogic-webmail:afterlogic-webmail /var/www/afterlogic/data
sudo chmod 750 /var/www/afterlogic/data

# Configure firewall
sudo firewall-cmd --permanent --add-service=afterlogic-webmail
sudo firewall-cmd --reload

# Enable SELinux policies (if applicable)
sudo setsebool -P httpd_can_network_connect on

# Configure fail2ban
sudo tee /etc/fail2ban/jail.d/afterlogic-webmail.conf << 'EOF'
[afterlogic-webmail]
enabled = true
port = 80/443
filter = afterlogic-webmail
logpath = /var/log/afterlogic/*.log
maxretry = 5
bantime = 3600
EOF

bash

# Generate SSL certificates
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout /etc/ssl/private/afterlogic-webmail.key \
    -out /etc/ssl/certs/afterlogic-webmail.crt

# Configure SSL in afterlogic-webmail
# See official documentation for SSL configuration

PostgreSQL Backend (if applicable)

bash

# Create database and user
sudo -u postgres psql << EOF
CREATE DATABASE afterlogic-webmail_db;
CREATE USER afterlogic-webmail_user WITH ENCRYPTED PASSWORD 'secure_password';
GRANT ALL PRIVILEGES ON DATABASE afterlogic-webmail_db TO afterlogic-webmail_user;
EOF

# Configure afterlogic-webmail to use PostgreSQL
# See official documentation for database configuration

bash

# Create database and user
sudo mysql << EOF
CREATE DATABASE afterlogic-webmail_db;
CREATE USER 'afterlogic-webmail_user'@'localhost' IDENTIFIED BY 'secure_password';
GRANT ALL PRIVILEGES ON afterlogic-webmail_db.* TO 'afterlogic-webmail_user'@'localhost';
FLUSH PRIVILEGES;
EOF

bash

# Kernel parameters
sudo tee -a /etc/sysctl.conf << EOF
net.core.somaxconn = 65535
net.ipv4.tcp_max_syn_backlog = 65535
net.ipv4.ip_local_port_range = 1024 65535
net.core.netdev_max_backlog = 5000
vm.swappiness = 10
EOF

sudo sysctl -p

# AfterLogic WebMail specific tuning
EnableCaching = true

bash

# Configure system limits
sudo tee -a /etc/security/limits.conf << EOF
afterlogic-webmail soft nofile 65535
afterlogic-webmail hard nofile 65535
afterlogic-webmail soft nproc 32768
afterlogic-webmail hard nproc 32768
EOF

yaml

# prometheus.yml configuration
scrape_configs:
  - job_name: 'afterlogic-webmail'
    static_configs:
      - targets: ['localhost:80/443']
    metrics_path: '/metrics'

bash

# Basic health check script
#!/bin/bash
if systemctl is-active --quiet httpd; then
    echo "AfterLogic WebMail is running"
    exit 0
else
    echo "AfterLogic WebMail is not running"
    exit 1
fi

bash

# Configure log rotation
sudo tee /etc/logrotate.d/afterlogic-webmail << 'EOF'
/var/log/afterlogic/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 afterlogic-webmail afterlogic-webmail
    postrotate
        systemctl reload httpd > /dev/null 2>&1 || true
    endscript
}
EOF

bash

#!/bin/bash
# AfterLogic WebMail backup script
BACKUP_DIR="/backup/afterlogic-webmail"
DATE=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# Stop service (if required)
systemctl stop httpd

# Backup configuration
tar -czf "$BACKUP_DIR/afterlogic-webmail-config-$DATE.tar.gz" /var/www/afterlogic/data

# Backup data (adjust paths as needed)
tar -czf "$BACKUP_DIR/afterlogic-webmail-data-$DATE.tar.gz" /var/lib/afterlogic-webmail

# Start service
systemctl start httpd

# Clean old backups (keep 30 days)
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

echo "Backup completed: $BACKUP_DIR"

bash

# Stop service
sudo systemctl stop httpd

# Restore configuration
sudo tar -xzf /backup/afterlogic-webmail/afterlogic-webmail-config-*.tar.gz -C /

# Restore data
sudo tar -xzf /backup/afterlogic-webmail/afterlogic-webmail-data-*.tar.gz -C /

# Set permissions
sudo chown -R afterlogic-webmail:afterlogic-webmail /var/www/afterlogic/data
sudo chown -R afterlogic-webmail:afterlogic-webmail /var/lib/afterlogic-webmail

# Start service
sudo systemctl start httpd

1. Service won't start:

bash

# Check logs
sudo journalctl -u httpd -n 100
sudo tail -f /var/log/afterlogic/*.log

# Check configuration
sudo afterlogic-webmail -t || sudo httpd configtest

# Check permissions
ls -la /var/www/afterlogic/data
ls -la /var/lib/afterlogic-webmail

2. Connection refused:

bash

# Check if service is listening
sudo ss -tlnp | grep 80/443
sudo netstat -tlnp | grep 80/443

# Check firewall
sudo firewall-cmd --list-all
sudo iptables -L -n

# Test connection
telnet localhost 80/443
nc -zv localhost 80/443

3. Performance issues:

bash

# Check resource usage
top -p $(pgrep httpd)
htop -p $(pgrep httpd)

# Check connections
ss -ant | grep :80/443 | wc -l

# Monitor I/O
iotop -p $(pgrep httpd)

bash

# Run in debug mode
sudo afterlogic-webmail -d
# or
sudo httpd debug

# Increase log verbosity
# Edit configuration to enable debug logging

yaml

version: '3.8'
services:
  afterlogic-webmail:
    image: afterlogic-webmail:latest
    container_name: afterlogic-webmail
    ports:
      - "80/443:80/443"
    volumes:
      - ./config:/var/www/afterlogic/data
      - ./data:/var/lib/afterlogic-webmail
    environment:
      - afterlogic-webmail_CONFIG=/var/www/afterlogic/data/afterlogic-webmail.conf
    restart: unless-stopped
    networks:
      - afterlogic-webmail_net

networks:
  afterlogic-webmail_net:
    driver: bridge

yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: afterlogic-webmail
spec:
  replicas: 3
  selector:
    matchLabels:
      app: afterlogic-webmail
  template:
    metadata:
      labels:
        app: afterlogic-webmail
    spec:
      containers:
      - name: afterlogic-webmail
        image: afterlogic-webmail:latest
        ports:
        - containerPort: 80/443
        volumeMounts:
        - name: config
          mountPath: /var/www/afterlogic/data
      volumes:
      - name: config
        configMap:
          name: afterlogic-webmail-config
---
apiVersion: v1
kind: Service
metadata:
  name: afterlogic-webmail
spec:
  selector:
    app: afterlogic-webmail
  ports:
  - port: 80/443
    targetPort: 80/443
  type: LoadBalancer

yaml

---
- name: Install and configure AfterLogic WebMail
  hosts: all
  become: yes
  tasks:
    - name: Install afterlogic-webmail
      package:
        name: afterlogic-webmail
        state: present
    
    - name: Configure afterlogic-webmail
      template:
        src: afterlogic-webmail.conf.j2
        dest: /var/www/afterlogic/data/afterlogic-webmail.conf
        owner: afterlogic-webmail
        group: afterlogic-webmail
        mode: '0640'
      notify: restart afterlogic-webmail
    
    - name: Start and enable afterlogic-webmail
      systemd:
        name: httpd
        state: started
        enabled: yes
  
  handlers:
    - name: restart afterlogic-webmail
      systemd:
        name: httpd
        state: restarted

Maintenance

bash

# RHEL/CentOS/Rocky/AlmaLinux
sudo dnf update afterlogic-webmail

# Debian/Ubuntu
sudo apt update && sudo apt upgrade afterlogic-webmail

# Arch Linux
sudo pacman -Syu afterlogic-webmail

# Alpine Linux
apk update && apk upgrade afterlogic-webmail

# openSUSE
sudo zypper update afterlogic-webmail

# FreeBSD
pkg update && pkg upgrade afterlogic-webmail

# Always backup before updates
tar -czf /backup/afterlogic-webmail-pre-update-$(date +%Y%m%d).tar.gz /var/www/afterlogic/data

# Restart after updates
sudo systemctl restart httpd

Regular Maintenance Tasks

bash

# Clean logs
find /var/log/afterlogic -name "*.log" -mtime +30 -delete

# Verify integrity
sudo afterlogic-webmail --verify || sudo httpd check

# Update databases (if applicable)
sudo afterlogic-webmail-update-db

# Optimize performance
sudo afterlogic-webmail-optimize

# Check for security updates
sudo afterlogic-webmail --security-check

Official Documentation: https://docs.afterlogic-webmail.org/

GitHub Repository: https://github.com/afterlogic-webmail/afterlogic-webmail

Community Forum: https://forum.afterlogic-webmail.org/

Wiki: https://wiki.afterlogic-webmail.org/

Comparison vs Roundcube, RainLoop, SquirrelMail, Horde: https://docs.afterlogic-webmail.org/comparison

---

Note: This guide is part of the HowToMgr collection. Always refer to official documentation for the most up-to-date information.

1. Prerequisites

2. Supported Operating Systems

3. Installation

RHEL/CentOS/Rocky Linux/AlmaLinux

Debian/Ubuntu

Arch Linux

Alpine Linux

openSUSE/SLES

macOS

FreeBSD

Windows

Initial Configuration

Basic Configuration

Security Hardening

5. Service Management

systemd (RHEL, Debian, Ubuntu, Arch, openSUSE)

OpenRC (Alpine Linux)

rc.d (FreeBSD)

launchd (macOS)

Windows Service Manager

Advanced Configuration

Performance Optimization

Clustering and High Availability

Reverse Proxy Setup

nginx Configuration

Apache Configuration

HAProxy Configuration

Security Configuration

Basic Security Setup

SSL/TLS Configuration

Database Setup

PostgreSQL Backend (if applicable)

MySQL/MariaDB Backend (if applicable)

Performance Optimization

System Tuning

Resource Limits

Monitoring

Prometheus Integration

Health Checks

Log Monitoring

9. Backup and Restore

Backup Script

Restore Procedure

6. Troubleshooting

Common Issues

Debug Mode

Integration Examples

Docker Compose

Kubernetes Deployment

Ansible Playbook

Maintenance

Update Procedures

Regular Maintenance Tasks

Additional Resources

Related Webmail Guides

Horde Installation Guide

RainLoop Installation Guide

Roundcube Installation Guide