Unlocking Empress: Mastering SSH Access and Certificate Generation

Guides & Tutorials
1

Introduction

Are you looking to enhance your business operations with Empress? In this guide, we’ll discuss how to use one of Empress’s handy features: SSH Access and Certificate Generation. This feature allows you to securely connect to your Empress Bench and perform various actions.

Why is SSH Access Important?

SSH Access is a powerful tool that allows you to directly interact with your Empress Bench. It’s like having a key to a private room, where you have the control to make changes, run commands, and tweak settings. This kind of access can be incredibly useful in managing your business operations effectively.

Adding an SSH Key to Your Empress Account

Here’s how you can add an SSH Key to your Empress Account:

  1. Navigate to your Empress Cloud dashboard and click on Settings.
  2. Scroll down until you find the “SSH Key” section.
  3. Click on “New SSH Key”. You’ll see a dialog box with an input field.
  4. Input your SSH public key in this field.

Remember, only one SSH key can be added per user.

Generating an SSH Certificate

Accessing your Empress Bench via SSH requires a valid SSH certificate. Here’s how you generate one:

  1. Go to your Bench dashboard and find the Versions tab.
  2. If your SSH key was added correctly, you should see an “SSH Access” option in the Actions section of your bench version page.
  3. Click on the Generate SSH Certificate button. This creates a certificate that is valid for six hours.

Remember, every time you need SSH access to a particular bench version, you’ll need to generate a new SSH certificate.

Connecting to Your Bench using SSH

After generating your SSH certificate, you’re ready to connect:

  1. Follow the instructions displayed in the dialog box after certificate generation.
  2. Copy and paste the provided commands into your terminal.
  3. Run the given ssh command to access your bench.

Now, you can run any desired commands, such as bench restart or bench build.

Troubleshooting SSH Issues

If you encounter any problems while trying to gain SSH access, don’t hesitate to raise a support ticket. Our team is here to assist you!

FAQ

Here are some common queries regarding SSH access:

  • If you encounter an “Access denied on SSH: Private key contents do not match public” error, ensure the key on Empress Cloud matches the one on your local machine.
  • Please note that SSH from PowerShell on Windows is currently unsupported.
  • Copying files over SSH (SCP) and VS Code over SSH are not supported due to our use of a proxy connection for SSH sessions.

With SSH Access and Certificate Generation, you have even more control and flexibility in your hands to manage and optimize your business operations with Empress. Happy managing!