<!--
  canonical-url: https://www.avonture.be/blog/windows-terminal-ssh-profile
  published:     2026-01-19
  This is a static plain-Markdown mirror generated at build time.
  Visit the canonical URL above for the fully rendered page, with images and interactive components.
-->

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

---
![Windows Terminal - Adding a SSH profile](/img/v2/adding_ssh_profile_to_windows_terminal.webp)

**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](/blog/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](./images/windows_terminal_ssh_profile.webp)

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:

1. Click on the `+` button to open a new tab, then select "Settings" from the dropdown menu.

2. Press `Ctrl + ,` while in Windows Terminal.

3. Right-click on the title bar and select "Settings".

4. Use the command `wt -p` in PowerShell or CMD.

![Getting access to Windows Terminal Settings](./images/windows_terminal_access_to_settings.webp)

### 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](/blog/connect-using-ssh-to-your-hosting-server).

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:

1. Open the Settings of Windows Terminal,

2. In the left menu, select "Add a new profile",

3. Click on "New empty profile",

4. In the "Name" field, type "SSH - PlanetHoster" (or anything else you want),

5. In the "Command line" field, type `ssh planethoster` (or the alias you defined in your `~/.ssh/config` file),

6. Optionally, choose an icon for your profile by clicking on the "Browse" button or paste here an emoji like "⚡",

7. 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](./images/windows_terminal_ssh_profile_with_background.webp)

## 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](/blog/windows-terminal-split-panes) to monitor several remote servers side by side in a single window.
