Persistently configure the OpenSSH daemon on Linux

Abstract: Resolve OpenSSH configuration changes reverting after reboot by editing sshd_config and restarting the service.

Created: 2026-07-29 by
To persistently configure the OpenSSH daemon on Linux, you must edit the main configuration file at /etc/ssh/sshd_config and then restart or reload the sshd service. This ensures that security hardening measures, such as disabling root login or changing the default port, survive system reboots and do not revert to defaults. Always back up the original configuration before making changes to prevent lockout scenarios.

Locating and Backing Up the Configuration File

The primary configuration file for the OpenSSH server is located in the /etc/ssh/ directory. The specific file you need to modify is named sshd_config. Before making any edits, it is critical to create a backup copy. This safety net allows you to restore the previous state if a syntax error prevents the SSH service from starting. Run the following command to create a timestamped backup:
sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
This command copies the current active configuration to a new file with the .bak extension. If you encounter issues after editing, you can simply copy this backup back over the active file. Using a text editor like nano or vim with sudo privileges is the standard approach for editing this file. For example:
sudo nano /etc/ssh/sshd_config

Essential Security Hardening Steps

Hardening your SSH daemon is the most common reason for persistent configuration. Several directives in sshd_config significantly reduce the attack surface of your server. You should review and adjust the following key settings. First, disable root login via SSH. Allowing direct root access is a major security risk because it exposes the highest privilege account to brute-force attacks. Find the line starting with PermitRootLogin and change it to:
PermitRootLogin no
Next, consider disabling password authentication entirely in favor of key-based authentication. Passwords are susceptible to guessing and phishing. To enforce key-only access, set:
PasswordAuthentication no
If you still require password authentication for specific legacy systems, ensure that empty passwords are rejected by setting:
PermitEmptyPasswords no
Another important setting is X11Forwarding. Unless you specifically need to run graphical applications remotely, this feature should be disabled to prevent potential X11 security vulnerabilities. Set it to:
X11Forwarding no
For more advanced security, you can restrict which users or groups are allowed to log in using the AllowUsers or AllowGroups directives. This creates an explicit whitelist, ensuring that only designated accounts can establish SSH connections.

Changing the Default Port

While not a strict security measure (since attackers scan all ports), changing the default SSH port from 22 to a non-standard port reduces noise from automated bots scanning the internet. Look for the Port directive near the top of the file and uncomment it if necessary. Change the value to your desired port, for example:
Port 2222
Remember that if you change the port, you must also update your firewall rules to allow traffic on the new port. Failure to do so will result in immediate loss of connectivity.

Validating Configuration Syntax

Before restarting the service, you must verify that your configuration file contains no syntax errors. The OpenSSH daemon provides a built-in test mode for this purpose. Run the following command:
sudo sshd -t
If the command returns no output, the configuration is valid. If there are errors, the command will print the specific line number and description of the problem. Fix these errors in sshd_config and run the test again until it passes silently. This step is crucial because a syntax error can prevent the SSH service from starting, potentially locking you out of your server if you are connected remotely.

Applying Changes Persistently

Once the configuration is validated, you need to apply the changes. You have two options: reloading the service or restarting it. Reloading is generally preferred because it maintains existing connections while applying new configurations to new sessions. However, certain changes, like altering the port or protocol version, may require a full restart. To reload the service:
sudo systemctl reload sshd
To restart the service completely:
sudo systemctl restart sshd
After applying changes, test the connection from another machine or a different terminal session to ensure that the new settings are active. Do not close your current session until you have verified that the new configuration works correctly.

Handling Related Issues

Sometimes, configuration changes lead to unexpected behaviors, such as permission denied errors when using keys. If you find that your key-based authentication fails after configuring the daemon, check the permissions on the authorized_keys file. You may need to manually add keys or fix ownership issues. For detailed guidance on resolving permission issues related to SSH keys, refer to our guide on Fixing "Permission denied» with OpenSSH: Manually adding authorized_keys. Additionally, if you notice high CPU usage after making configuration changes, it might indicate a misconfiguration causing excessive logging or processing loops. In such cases, monitoring the daemon's resource consumption is essential. See our analysis on Resolving High CPU Usage by a Daemon Process in Plesk Linux VPS for troubleshooting steps that apply to daemon-related performance issues.

Frequently Asked Questions

How do I revert to the default SSH configuration?

You can restore the default configuration by replacing your modified file with the backup you created earlier. Simply use the command sudo cp /etc/ssh/sshd_config.bak /etc/ssh/sshd_config and then restart the SSH service. This returns all settings to their distribution defaults.

Why does my SSH connection fail after changing the port?

If you change the port in sshd_config but do not update your firewall rules, incoming connections will be blocked. Ensure that your firewall, such as UFW or firewalld, allows traffic on the new port number before testing the connection.

Can I enable both password and key-based authentication?

Yes, you can enable both by setting PasswordAuthentication yes and ensuring PubkeyAuthentication yes is present. However, this is less secure than key-only authentication. It is recommended to disable passwords once you have verified that key-based login works reliably for all users.

What happens if I make a typo in sshd_config?

A syntax error in sshd_config will prevent the SSH daemon from starting. If you are connected remotely, you will lose access to the server. Always use sudo sshd -t to validate the config before restarting the service, and keep a console or physical access available if possible.

Does changing the SSH port improve security?

Changing the port provides "security through obscurity" by reducing exposure to automated bot scans. It does not protect against targeted attacks, as determined attackers will scan all ports. Combine port changes with other hardening measures like fail2ban and key-based authentication for better results.

Latest News

How to Display Output of xterm Command in Terminal Screen using Cron

Resolve the inability to display xterm output in a terminal screen from cron by redirecting logs or using wall instead of insecure X11 workarounds.

Read More
Expose Local Server on VPS Preserving Real Client IPs (OS Level)

Resolve VPS logging showing only gateway IPs by configuring reverse proxies to forward real client addresses via X-Forwarded-For headers.

Read More
How to Clear Recent Files History in Linux without Deleting Actual Files?

Clear recent files history in Linux by deleting ~/.local/share/recently-used.xbel without removing the actual files.

Read More
Best HDD Copy Strategy: Manually Syncing and Rewriting Scratch

Resolve data drift between two 4TB hard drives by using rsync with the --delete flag to manually sync and rewrite scratch data for an exact mirror.

Read More
Understanding Bash Prompt Abbreviations: An Overview

Resolve repetitive typing errors by creating and persisting Bash aliases in the .bashrc file for improved command-line efficiency.

Read More
Free Tools and Methods to Log Real-Time Performance Details in Task Manager

Log real-time CPU and memory metrics to CSV files using Windows Performance Monitor Data Collector Sets to troubleshoot system slowness.

Read More
Contact Qatar Airways Customer Service: Phone Number, Help Center, and More

Resolve urgent Qatar Airways reservation issues like flight changes and baggage claims using the US phone number +1801-855-5905 or online self-service tools.

Read More
Windows 11: Alt Codes Displaying Wrong Characters - Solutions

Resolve Windows 11 Alt codes showing wrong characters by verifying the US keyboard layout and enabling Num Lock.

Read More
Run Programs with Elevated Privileges: A Comprehensive Guide

Eliminates the need to type sudo for frequent administrative tasks by configuring .bashrc aliases or functions.

Read More
Dynamically Changing Dates in Excel Formulas Using Cells

Eliminate manual date updates in Excel by using cell references to create dynamic formulas that automatically adjust calculations when input dates change.

Read More
Granting Edit Access to a Specific Excel Sheet in an Office 365 User Email ID-Based Login

Excel Online lacks native sheet-level permissions, so users must split workbooks or use worksheet protection to isolate edit access for specific tabs.

Read More
Creating Network Load on Local Wi-Fi from One PC

Generate sustained Wi-Fi bandwidth load from a single PC using a VM SFTP server to test router stability and throughput.

Read More
Changing the Default Editor for Batch Files in Windows 11's File Explorer

Resolve the issue of batch files opening in Notepad by changing the default editor to a preferred application like VS Code.

Read More
Gain WiFi Connection Minutes Before Losing it by Changing MAC Address

Bypass MAC address filtering to restore WiFi connectivity temporarily when a device is blocked by network administrators.

Read More
Photos Folders Turned Black: Troubleshooting Picture Applications on Windows

Resolve black screens in Windows Photos by resetting the app, updating graphics drivers, and repairing system files.

Read More
Troubleshooting High CPU Temperature Values: A Step-by-Step Guide

Resolve high CPU temperatures and thermal throttling by monitoring with Speedfan, cleaning dust from cooling components, and replacing degraded thermal paste.

Read More
Make cURL establish TLS connection with CA unknown

Resolve cURL TLS connection failures with unknown or self-signed certificates by using the --insecure flag to bypass CA validation.

Read More
Troubleshooting Incorrect Network Metrics Values in Grafana, Prometheus, InfluxDB, and Telegraf

Fix incorrect network metrics in Grafana, Prometheus, InfluxDB, and Telegraf by verifying interface selection, resolving unit mismatches, and handling counter resets.

Read More
Start Another Terminal Window (cmd.exe) Windows Repair/Troubleshoot

Provides step-by-step instructions to access the Windows Command Prompt via bootable media for advanced system repair and troubleshooting.

Read More
Thinkpad P1 Gen 6: Sudden Thunderbolt 3 Dock USB-C Charging Stopped Working

Resolve sudden Thunderbolt 3 dock USB-C charging and internet failure on ThinkPad P1 Gen 6 by updating firmware, resetting the dock, and adjusting power settings.

Read More
ASUS Windows 11 Laptop: Internet Connection Issue with Hotspot

Resolve ASUS Windows 11 laptop spinning wheel issue when connecting to mobile hotspot by resetting network stack, disabling IPv6, and adjusting power settings.

Read More
Developing iOS Project with Firebase: Logging in and Sending Push Notifications

Integrates Firebase to enable secure user authentication and push notifications in iOS applications.

Read More
Troubleshooting Bash Script with Suspected Issues of Spaces, Dashes, Filenames and Quoting

Resolve Bash script failures caused by word splitting, globbing, and special characters in filenames by applying proper quoting techniques.

Read More
Populating OneDrive Folder for Local Backup without Affecting Remote Files

Prevent OneDrive from deleting remote files during Windows reinstallation by unlinking the account or using symbolic links to isolate local data.

Read More
Force First Frame as Keyframe Without Re-encoding: A Quick Solution

Resolve inaccurate seeking and playback glitches by re-encoding video to ensure the first frame is a valid keyframe.

Read More
Find Information in Database Using WSL (Ubuntu) on Windows-10

Resolve database connection issues from WSL Ubuntu on Windows 10 by configuring client tools and network access to query remote or local servers.

Read More
Configuring a New Router with Different Networks: One Family, One Guest

Resolve IP conflicts and isolate guest traffic by configuring a second router with a distinct subnet via its WAN port.

Read More
Quickly Open Multiple Stock Websites with a Single Command

Solve the problem of manually opening multiple stock research websites by creating a single command to launch them simultaneously on Windows, macOS, or Linux.

Read More
Improved Adobe Acrobat Search Experience: Access Advanced Search with Ease

Access advanced search filters like case sensitivity and regex in Adobe Acrobat by clicking More Options in the Find bar.

Read More
Port Forwarding VM via OpenVPN: A Comprehensive Guide

Configure OpenVPN server and iptables to forward specific ports from VPN clients to a virtual machine's internal IP address.

Read More
Understanding Partitions in the 1980s: A Look Back at MS-DOS and Master Boot Record

Explains how the Master Boot Record and partition table enabled MS-DOS to manage multiple disk volumes on a single physical drive.

Read More
Windows 10 Enterprise: Keyboard Not Detected in Managed Organization with Admin Privileges

Resolve Windows 10 Enterprise keyboard detection failures caused by Group Policy restrictions, driver corruption, or USB enumeration errors.

Read More
Can't Find x86_64 Versions of Applications on MacOS arm64 (M1)

Resolve missing x86_64 app issues on M1 Macs by installing Rosetta 2 and reinstalling apps as universal binaries.

Read More
How to Hide Installation Source for an Android App

Manage Android app installation source visibility by using USB transfers or file managers to reduce browser traces and isolate data via work profiles.

Read More
Connecting Momentus 4200.2 ST9808210A Hard Drive via USB Cable

Resolve inability to access Seagate Momentus 4200.2 ST9808210A hard drive by connecting it via USB using a compatible SATA-to-USB adapter and configuring the disk in Windows.

Read More