Users & Access · about 1 min · 4 steps
SSH sign-in banner
Shows a short notice, such as "Authorized access only", before anyone signs in with SSH.
Runs on
- Debian / Ubuntu: supported
- RHEL / Fedora: supported
- Alpine: supported
Before you start
- This server has no OpenSSH server (sshd).
What it changes on your server
- Writes the text to /etc/ssh/shellbay-banner.txt and points SSH at it in /etc/ssh/sshd_config.d/10-shellbay-banner.conf.
- Adds an Include line to /etc/ssh/sshd_config if it has none. The previous configuration is kept with the run, and any failure restores it.
- Reloads SSH without closing sessions. Leave the text empty to remove the banner.
What Shellbay asks you
What should the banner say?
One line of text, shown before sign-in by most SSH apps. Don't include anything secret. Leave it empty to remove a banner Shellbay set before.
- Banner text (optional)
- Text, up to 300 characters. Default:
Authorized access only. Activity on this server may be monitored.
Example:
Authorized access only.
Steps
- Write the banner settings
- Validate the new settings
- Apply without closing your session
- Check the banner
Shellbay checks the server before the first step, and stops at the first step that fails.
When it's done
- New SSH connections show the banner before sign-in. Sessions already open aren't affected.