Skip to main content

Windows Terminal - Adding a SSH profile

Adding a SSH profile to Windows Terminal to quickly connect to your servers without typing the full SSH command each time.

· 4 min read
View raw
Christophe
Markdown, WSL and Docker lover ~ Insatiable curious.
Cet article existe aussi en français — lire la version française.

Windows Terminal - Adding a SSH profile

⚡
TL;DR

This guide demonstrates how to streamline server connections by creating a dedicated SSH profile directly within the Windows Terminal settings. Users simply need to add a new empty profile, configure the command line with their specific SSH instruction, and optionally customize the appearance with icons or background images. This setup enables immediate access to remote servers through the Terminal dropdown menu, eliminating the need to manually type connection commands.

In this article, we'll see how to create a new SSH profile in Windows Terminal so we no longer even need to remember how to connect to the server; we just need to open the profile and that's all.

For illustration purposes, I'll use my hosting server at PlanetHoster, but you can use the same technique for any SSH server you want to connect to.

The Result​

Once the profile is created (covered below), connecting to the server is one click from the dropdown menu next to the + button:

The new SSH profile in Windows Terminal

Select it, and a new console opens, already connected via SSH.

Why It Works​

  • No more retyping the ssh planethoster command — the profile carries it for you.
  • The server is reachable straight from the Terminal dropdown menu, alongside your other profiles.
  • Fully customizable — an icon, a background image, its own color scheme, whatever helps you spot it at a glance.

Installation​

Open Windows Terminal Settings​

To open the Windows Terminal settings, you can use the following methods:

  • Click on the + button to open a new tab, then select "Settings" from the dropdown menu.
  • Press Ctrl + , while in Windows Terminal.
  • Right-click on the title bar and select "Settings".
  • Use the command wt -p in PowerShell or CMD.

Getting access to Windows Terminal Settings

Add a profile for any SSH connection​

In a recent article, we've seen how to create an SSH profile and be able to run a command like ssh planethoster (or anything else). If you missed it, please read How to connect to your hosting server using SSH.

So, right now, to connect to your hosting server, you only need to run ssh planethoster in a Windows Terminal console (PowerShell, CMD or WSL).

Let's see how to create a Windows Terminal profile that will directly open a console connected to your hosting server:

  • Open the Settings of Windows Terminal,
  • In the left menu, select "Add a new profile",
  • Click on "New empty profile",
  • In the "Name" field, type "SSH - PlanetHoster" (or anything else you want),
  • In the "Command line" field, type ssh planethoster (or the alias you defined in your ~/.ssh/config file),
  • Optionally, choose an icon for your profile by clicking on the "Browse" button or paste here an emoji like "⚡",
  • Finally, click on the "Save" button at the bottom right.

The change is immediate: by clicking on the down arrow next to the + button, you'll see your new profile — exactly the result shown at the top of this article.

More Demos​

Adding a background image (optional)​

Go back to the Settings, select your newly created profile (SSH - PlanetHoster in our example) and scroll down to the "Appearance" section and click on it to expand it.

In the "Background image path" field, click on the "Browse" button and select an image file on your computer (for example a .jpg or a .webp file).

Adjust any other settings you want (for example the "Background image opacity" slider to make the image more or less visible).

Click on the "Save" button at the bottom right.

The SSH profile with a background image

Conclusion​

From now on, whenever you want to connect to your hosting server, just open Windows Terminal and select your SSH profile. A new console will open, automatically connected to your server via SSH.

Close the console to end the session when you're done.

Additionally, pay attention to any other settings you can customize in the profile, such as font size, color scheme, and more, to enhance your experience. You can also define the home directory to open when the profile starts.

Want to go further? Combine this SSH profile with split panes to monitor several remote servers side by side in a single window.


Was this article helpful?
Did you try the steps in this article?
🦋 Join the conversation on BlueskyRequires a free Bluesky account to like, repost or comment. This block talks to Bluesky's public API directly from your browser (no cookies, no sign-in) — that means your IP address reaches Bluesky's servers just by this section loading.

Loading comments…