🚀 How to Install AlternC on Debian VPS

This article provides a guide demonstrating how to install AlternC on Debian VPS.

What is AlternC?

AlternC is an open-source web hosting control panel and shared hosting management platform for Linux servers, primarily designed for Debian-based systems. It provides a lightweight alternative to commercial hosting panels like cPanel or Plesk.

It was originally developed by French hosting and free-software communities to provide a fully open-source hosting environment for multi-user web hosting.

What AlternC Does

AlternC allows a server administrator to manage:

• Websites and virtual hosts
• Domains and DNS zones
• Email accounts
• FTP accounts
• MySQL/MariaDB databases
• Webmail
• Shared hosting users
• Disk quotas
• SSL certificates

It essentially turns a Debian VPS or dedicated server into a multi-tenant hosting platform.

Core Components

AlternC typically integrates with:

Typical Use Cases

AlternC is commonly used for:

• Shared hosting environments
• Small hosting providers
• Educational hosting platforms
• Non-profit hosting projects
• Self-hosted web/mail servers
• Lightweight alternative to commercial panels

Key Features

Multi-user Hosting

Each user can manage:

• Their own domains
• Mailboxes
• FTP accounts
• Databases
• Web files

Without root access.

Integrated DNS Management

AlternC can act as an authoritative DNS server.

Users can:

• Create DNS zones
• Manage records
• Host nameservers

Mail Hosting

Provides:

• SMTP
• IMAP
• POP3
• Mail aliases
• Autoresponders
• Spam filtering

Database Management

Supports:

• MySQL
• MariaDB

Including:

• Database creation
• User permissions
• phpMyAdmin integration

Web Hosting Features

Supports:

• PHP websites
• Static websites
• SSL certificates
• Apache virtual hosts
• Multiple domains per account

Advantages of AlternC

Fully Open Source

Unlike many commercial hosting panels, AlternC is free software.

Lightweight

Compared to larger control panels, AlternC can consume fewer resources.

Good for:

• Small VPS deployments
• Low-memory systems
• Community hosting servers

Debian-Focused

AlternC is tightly integrated with Debian packaging and administration practices.

This makes it attractive for administrators already comfortable with Debian systems.

No Per-Account Licensing

No recurring licensing fees.

Useful for:

• Hosting startups
• Budget hosting
• Internal hosting platforms

AlternC vs cPanel

When AlternC Makes Sense

AlternC is a good fit if you want:

• A free hosting panel
• Debian-native hosting management
• Lightweight shared hosting
• Multi-user website hosting
• Full control over the stack
• Open-source infrastructure

When AlternC May Not Be Ideal

You may prefer another platform if you need:

• Commercial support
• Large-scale reseller hosting
• WHMCS integrations
• Enterprise automation
• CloudLinux compatibility
• Massive plugin ecosystems
• Advanced GUI tooling

Alternatives to AlternC

Common alternatives include:

• ISPConfig
• HestiaCP
• CyberPanel
• Virtualmin

Official Project Resources

• AlternC Official Website
• AlternC Debian Repository
• AlternC Documentation

Compare Debian VPS Plans

How to Install AlternC on Debian VPS

1. Recommended VPS requirements

   Use a clean Debian VPS:

   • Debian 12 Bookworm
   • 2 CPU cores minimum
   • 2 GB RAM minimum
   • 20+ GB disk
   • Static public IPv4
   • Root SSH access
   • Fully qualified hostname

   Example hostname:

   panel.example.com
   

   Do not install AlternC on a server already running cPanel, Plesk, ISPConfig, DirectAdmin, custom Postfix/Dovecot/Apache stacks, or production websites. AlternC installs and manages its own web, mail, DNS, database, and hosting services.

2. Point DNS to the VPS

   Before installing, create these DNS records at your DNS provider:

   panel.example.com.      A      YOUR_SERVER_IP
   ns1.example.com.        A      YOUR_SERVER_IP
   mail.example.com.       A      YOUR_SERVER_IP
   

   Optional but recommended:

   example.com.            MX 10  mail.example.com.
   

   If AlternC will manage DNS for hosted domains, you will also want nameserver glue records at your registrar, for example:

   ns1.example.com → YOUR_SERVER_IP
   

3. Log in as root

   ssh root@YOUR_SERVER_IP
   

   Update the server:

   apt update
   apt upgrade -y
   reboot
   

   Reconnect after reboot:

   ssh root@YOUR_SERVER_IP
   

4. Set the hostname

   Replace the hostname with your real panel hostname:

   hostnamectl set-hostname panel.example.com
   

   Edit /etc/hosts:

   nano /etc/hosts
   

   Use something like:

   127.0.0.1       localhost
   YOUR_SERVER_IP  panel.example.com panel
   

   Verify:

   hostname -f
   

   Expected result:

   panel.example.com
   

5. Install basic tools

   apt install -y curl wget gnupg ca-certificates apt-transport-https lsb-release sudo nano
   

6. Verify Debian version

   cat /etc/os-release
   

   You want:

   VERSION_CODENAME=bookworm
   

   AlternC’s current official repository instructions specifically reference Bullseye and Bookworm, with Bookworm actively tested.

7. Check APT sources

   Make sure your Debian sources are valid.

   cat /etc/apt/sources.list
   

   A basic Debian 12 Bookworm setup should look similar to:

   deb http://deb.debian.org/debian bookworm main contrib non-free non-free-firmware
   deb http://deb.debian.org/debian bookworm-updates main contrib non-free non-free-firmware
   deb http://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
   

   Then update:

   apt update
   

8. Install AlternC

   The official AlternC Debian repository currently lists the Bookworm install process as:

   apt update
   apt install alternc
   alternc.install
   

   Run:

   apt install -y alternc
   

   During installation, Debian may ask package configuration questions. Answer according to your server details.

9. Run the AlternC installer

   After packages are installed, run:

   alternc.install
   

   You will be asked several configuration questions. Typical values:

   Public IP address: YOUR_SERVER_IP
   Server hostname: panel.example.com
   Primary domain: example.com
   DNS hostname: ns1.example.com
   Mail hostname: mail.example.com
   

   Use your actual domain and hostname.

10. Reboot after installation

    reboot
    

    Reconnect:

    ssh root@YOUR_SERVER_IP
    

11. Check service status

    Run:

    systemctl status apache2 --no-pager
    systemctl status postfix --no-pager
    systemctl status dovecot --no-pager
    systemctl status mariadb --no-pager
    systemctl status bind9 --no-pager
    

    Also check listening ports:

    ss -tulpn
    

    You should commonly see services listening on ports such as:

    80    HTTP
    443   HTTPS
    25    SMTP
    53    DNS
    110   POP3
    143   IMAP
    587   SMTP submission
    993   IMAPS
    3306  MariaDB local/private use
    

12. Access the AlternC panel

    Open:

    http://panel.example.com/
    

    or:

    http://YOUR_SERVER_IP/
    

    If HTTPS is not yet configured, start with HTTP first.

13. Secure the panel with HTTPS

    If Certbot is available on your Debian install:

    apt install -y certbot python3-certbot-apache
    

    Then request a certificate:

    certbot --apache -d panel.example.com
    

    Follow the prompts.

    Test renewal:

    certbot renew --dry-run
    

14. Open firewall ports

    If using UFW:

    apt install -y ufw
    ufw allow OpenSSH
    ufw allow 80/tcp
    ufw allow 443/tcp
    ufw allow 25/tcp
    ufw allow 587/tcp
    ufw allow 993/tcp
    ufw allow 53/tcp
    ufw allow 53/udp
    ufw enable
    ufw status
    

    Optional mail ports:

    ufw allow 110/tcp
    ufw allow 143/tcp
    ufw allow 465/tcp
    ufw allow 995/tcp
    

15. Configure reverse DNS

    Set PTR/rDNS for your VPS IP through your VPS provider.

    Recommended PTR:

    YOUR_SERVER_IP → mail.example.com
    

    Then verify:

    dig -x YOUR_SERVER_IP +short
    

16. Configure SPF, DKIM, and DMARC

    At minimum, add SPF:

    example.com. TXT "v=spf1 mx a ip4:YOUR_SERVER_IP -all"
    

    Add DMARC:

    _dmarc.example.com. TXT "v=DMARC1; p=quarantine; rua=mailto:postmaster@example.com"
    

    DKIM depends on your AlternC/Postfix configuration. Check whether DKIM tooling is installed:

    dpkg -l | grep -Ei 'dkim|opendkim'
    

17. Create your first AlternC account

    From the AlternC web interface:

    1. Log in as the administrator.
    2. Create a new member/user.
    3. Assign disk quota.
    4. Add a domain.
    5. Create mailbox accounts.
    6. Create databases if needed.
    7. Upload website files through FTP/SFTP or the AlternC file tools.

18. Test website hosting

    Create a test file:

    echo "AlternC is working" > /var/www/html/test.html
    

    Then visit:

    http://panel.example.com/test.html
    

    For hosted domains, add the domain inside AlternC, point DNS to the server, and test:

    curl -I http://example.com
    

19. Test mail delivery

    Install mail tools:

    apt install -y mailutils
    

    Send a test email:

    echo "AlternC mail test" | mail -s "Test email from AlternC VPS" you@example.net
    

    Watch logs:

    tail -f /var/log/mail.log
    

20. Common troubleshooting

    Package not found

    Run:

    apt update
    apt-cache policy alternc
    

    Confirm you are on Debian Bookworm:

    cat /etc/os-release
    

    Hostname problem

    Check:

    hostname -f
    cat /etc/hosts
    

    Apache not starting

    apachectl configtest
    journalctl -xeu apache2
    

    Mail not sending

    systemctl status postfix --no-pager
    tail -100 /var/log/mail.log
    

    DNS not answering

    systemctl status bind9 --no-pager
    dig @127.0.0.1 example.com
    

21. Maintenance commands

    Update Debian and AlternC packages:

    apt update
    apt upgrade -y
    

    Check failed services:

    systemctl --failed
    

    Check logs:

    journalctl -p err -xb
    

    Check disk usage:

    df -h
    du -sh /var/* 2>/dev/null
    

22. Recommended production hardening

    Install Fail2ban:

    apt install -y fail2ban
    systemctl enable --now fail2ban
    

    Disable root password login:

    nano /etc/ssh/sshd_config
    

    Set:

    PermitRootLogin prohibit-password
    PasswordAuthentication no
    

    Restart SSH:

    systemctl restart ssh
    

    Keep regular backups of:

    /etc
    /var/lib/mysql
    /var/www
    /var/alternc
    /home
    

Quick install summary

apt update
apt upgrade -y
hostnamectl set-hostname panel.example.com
apt install -y curl wget gnupg ca-certificates sudo nano
apt update
apt install -y alternc
alternc.install
reboot

AlternC should now be installed and ready at:

http://panel.example.com/

Conclusion

You now know how to install AlternC on Debian VPS.