Docs / DNS & Domains / Configuring Split-Horizon DNS on Linux

Configuring Split-Horizon DNS on Linux

By Admin · Feb 9, 2026 · Updated Apr 23, 2026 · 5 views · 3 min read

In this article, we'll walk through the complete process of working with split-horizon in a server environment. Understanding dns is essential for maintaining a reliable and performant infrastructure.

Zone Configuration

If you encounter issues during setup, check the system logs first. Most problems can be diagnosed by examining the output of journalctl or the application-specific log files in /var/log/.


# Check DNS records
dig example.com A +short
dig example.com MX +short
dig example.com TXT +short

# Full DNS trace
dig +trace example.com

# Check specific nameserver
dig @8.8.8.8 example.com A

Make sure to restart the service after applying these changes. Some settings require a full restart rather than a reload to take effect.

Important Notes

If you encounter issues during setup, check the system logs first. Most problems can be diagnosed by examining the output of journalctl or the application-specific log files in /var/log/.

Record Management

The split-horizon configuration requires careful attention to resource limits and security settings. On a VPS with limited resources, it's important to tune these parameters according to your available RAM and CPU cores.


# Zone file example: /etc/bind/zones/db.example.com
$TTL    86400
@       IN      SOA     ns1.example.com. admin.example.com. (
                        2024010101      ; Serial
                        3600            ; Refresh
                        1800            ; Retry
                        604800          ; Expire
                        86400 )         ; Minimum TTL

@       IN      NS      ns1.example.com.
@       IN      NS      ns2.example.com.
@       IN      A       198.51.100.10
www     IN      CNAME   @
mail    IN      A       198.51.100.11
@       IN      MX 10   mail.example.com.

This configuration provides a good balance between performance and resource usage. For high-traffic scenarios, you may need to increase the limits further.

Security Implications

The dns component plays a crucial role in the overall architecture. Understanding how it interacts with split-horizon will help you make better configuration decisions.

Resolver Setup

Before making changes to the configuration, always create a backup of the existing files. This ensures you can quickly roll back if something goes wrong during the setup process.


# Check DNS records
dig example.com A +short
dig example.com MX +short
dig example.com TXT +short

# Full DNS trace
dig +trace example.com

# Check specific nameserver
dig @8.8.8.8 example.com A

This configuration provides a good balance between performance and resource usage. For high-traffic scenarios, you may need to increase the limits further.

Common Issues and Solutions

  • Service won't start: Check the logs with journalctl -xe -u split-horizon. Common causes include port conflicts, missing configuration files, or insufficient permissions.
  • Connection timeout: Verify your firewall rules allow traffic on the required ports. Use ss -tlnp to confirm the service is listening on the expected port.
  • Permission denied errors: Ensure files and directories have the correct ownership. Use chown -R to fix ownership and chmod for permissions.

Conclusion

This guide covered the essential steps for working with split-horizon on a VPS environment. For more advanced configurations, refer to the official documentation. Don't hesitate to reach out to our support team if you need help with your specific setup.

Was this article helpful?