Skip to content

Connecting to Virtual Machines Using the SSH Connection Key

WEB-Bastion-interface

Warpgate is a secure SSH bastion that simplifies access management to servers. This document contains instructions on how to use Warpgate.

SSH pub key

To connect, you will need to provide the administrator with a password-protected ssh PUB-KEY

  • If you don't have an ssh key, you will have to generate one: 
    ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Connecting to Warpgate

SSH Connection via Warpgate

To connect via Warpgate, use the following command: 

ssh user:target-host@qcbas-qcint.quintessence.de -p 2222

Command Breakdown:

  • ssh — Command to initiate an SSH connection.

  • user — User account for authentication in Warpgate.

  • target-host — The name of the host you want to connect to.

  • @qcbas-qcint.quintessence.de — Warpgate server.

  • -p 2222 — Specifies the port for connection (Warpgate uses 2222).

After executing the command, you will connect to mentioned VM.

Example:

ssh mjackson:mghvtest@qcbas-qcint.quintessence.de -p 2222

Connecting to the Server via FileZilla

MacOS // Windows

Steps to Connect

  1. Open FileZilla and go to File → Site Manager (or press Command + S on macOS).

  2. Create a new site entry:

    • Click New site and give it a name, for example: asglhtest.

  3. Configure the connection settings:

General Settings (General tab)

  • Protocol: SFTP - SSH File Transfer Protocol
  • Host: qcbas-qcint.quintessence.de
  • Port: 2222
  • Logon Type: Key file
  • User: youruser:asglhtest
  • Key file: Specify the path to your private key file, for example:
    /Users/youruserfolder/.ssh/private.pem

Advanced Settings (Advanced tab)

  • You can leave these settings as default unless you need to specify a default remote directory.

Transfer Settings (Transfer Settings tab)

  • Leave the transfer mode as Default.

Connection

After filling in all the details, click Connect to establish the connection to the server.

Notes

  • Make sure your private key file has the correct permissions (chmod 600).
  • If the connection fails, check the host and port availability.
  • The username format (youruser:asglhtest) might differ depending on your environment.

img.png

On Windows configure WinSCP SFTP client

  • qcbas-qcint.quintessence.de / hostname

  • username:asghvtest / username (username is e.g. ekapteine /adueber etc)

  • port: 2222

  • Click on Advanced: and in SSH Authentication select the Private Key file location: (in the next step select to show all files and then the current file will be converted as required):

img_2.png img_1.png

File Transfer via SSH (SCP)

This document describes how to copy files to and from the host qcbas-qcint.quintessence.de using scp over SSH with a key file and a custom port.

Requirements

  • SSH private key file (e.g., id-rsa) with correct permissions (chmod 600)
  • Access to the host qcbas-qcint.quintessence.de
  • SSH port: 2222
  • Your username and environment in the format:
    youruser:mglhdev

Copying Files TO the Host

To copy a file from your local machine to the remote host, use the following command:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev local-file.txt qcbas-qcint.quintessence.de:/tmp/

Explanation

Parameter Description
-i Path to your SSH private key file
-P Port to use for SSH connection (2222)
-o User= User and environment (e.g., youruser:mglhdev)
local-file.txt The file you want to upload
qcbas-qcint.quintessence.de:/tmp/ Target directory on the remote host

Download Files FROM the Host

Download file:

To download a file from the remote host to your local machine, use the following command:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev qcbas-qcint.quintessence.de:/tmp/local-file.txt .

Download multiple files:

To download multiple files within on path from the remote host to your local machine:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev qcbas-qcint.quintessence.de:'/tmp/documents/*' .

Explanation

Parameter Description
-i Path to your SSH private key file
-P Port to use for SSH connection (2222)
-o User= User and environment (e.g., youruser:mglhdev)
qcbas-qcint.quintessence.de:/tmp/local-file.txt Path to the file on the remote host
. Destination directory on your local machine (current directory)

File Permissions Reminder

Make sure your SSH private key file has the correct permissions:

chmod 600 ./.ssh/id-rsa

Troubleshooting

  • Verify the host and port are correct.
  • Ensure your private key is valid and matches the host configuration.
  • Double-check the User format (youruser:mglhdev).

Examples

Uploading a file:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev document.pdf qcbas-qcint.quintessence.de:/tmp/

Downloading a file:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev qcbas-qcint.quintessence.de:/tmp/document.pdf .

Downloading multiple files:

scp -i ./.ssh/id-rsa -P 2222 -o User=youruser:mglhdev qcbas-qcint.quintessence.de:'/tmp/documents/*' .

Changelog

Date Author Message
2026-03-11 dmitrijshuks QC-0 added examples for ssh connection
2026-02-25 aresnikowa Merge remote-tracking branch 'origin/master'