Skip to content
Shellbay

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

  1. 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

  1. Write the banner settings
  2. Validate the new settings
  3. Apply without closing your session
  4. 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.