Skip to main content

​
Overview

Linking your shared hosting account with Loupp enables automated deployments, environment management, and server monitoring. This guide walks you through the complete process of establishing the connection between your shared hosting provider and Loupp.

​
Prerequisites

Before linking your shared hosting with Loupp, ensure you have:
  • Active shared hosting account with shell access enabled
  • Hosting provider that supports SSH connections
  • PHP and Composer available on your hosting
  • Sufficient disk space for your applications

​
Step-by-Step Linking Process

​
Step 1: Enable Shell Access on Your Hosting

First, you need to enable SSH access in your hosting control panel:
1

Access cPanel

Log in to your hosting provider’s cPanel dashboard
2

Navigate to Security

Go to the “Security” tab and select “SSH Access”
3

Enable SSH

Toggle the SSH button to “On” to enable shell access
Some hosting providers may require you to contact support to enable SSH access
cPanel SSH Access section with toggle button

SSH Access section in cPanel showing the toggle button

​
Step 2: Generate SSH Key in Loupp

Loupp will automatically generate SSH keys for secure server access:
1

Create Shared Hosting Server

In Loupp dashboard, navigate to “Shared Hosting Servers” and click “New Server”
2

Select Provider

Choose your hosting provider from the list or select “Custom” for unsupported providers
3

Configure Server Details

Fill in your server information:
  • Name: Descriptive identifier for your server
  • Domain: Your website domain
  • Server IP: Hosting server IP address
  • Username: Hosting account username
  • Port: SSH port (usually 21002 for shared hosting)
  • Files Directory: Where files are stored (default: repository name)
  • Public Directory: Publicly accessible directory (default: public_html)
4

Generate SSH Key

Loupp automatically generates a unique SSH key pair for your server

​
Step 3: Import SSH Key to Your Hosting

Copy the generated SSH key from Loupp and add it to your hosting account:
1

Copy SSH Key

Copy the generated SSH public key from Loupp dashboard
2

Access SSH Key Management

In cPanel, go to “Security” → “SSH Access” → “Manage SSH Keys”
3

Import Public Key

Click “Import” and paste the SSH key from Loupp into the “PUBLIC KEY” textbox
Make sure to copy the entire public key, including the “ssh-rsa” prefix and comment
4

Authorize the Key

Click “Manage Action” and then “Authorize” to activate the SSH key
cPanel SSH key import form with public key textbox

SSH Key import interface in cPanel

​
Step 4: Verify Connection

After importing the SSH key, Loupp will verify the connection:
1

Test Connection

Loupp automatically tests SSH connectivity to your server
2

Verify Status

Check that your server status shows as “Active” in the dashboard
The verification process may take a few minutes to complete
3

Check Logs

Review connection logs to ensure successful authentication

​
Troubleshooting Common Issues

​
SSH Connection Problems

Problem: SSH connection is refusedSolutions:
  • Verify SSH is enabled in your hosting control panel
  • Check if your hosting plan includes SSH access
  • Contact hosting provider to enable shell access
  • Verify the correct port number (usually 21002)
Problem: SSH key authentication failsSolutions:
  • Ensure the complete public key was copied
  • Verify the key is properly authorized in cPanel
  • Check that the username matches your hosting account
  • Try regenerating the SSH key in Loupp
Problem: Cannot connect on specified portSolutions:
  • Confirm the correct SSH port with your hosting provider
  • Try common ports: 22, 21002, 2222
  • Check if your hosting uses a custom SSH port
  • Verify firewall settings allow SSH connections

​
Hosting Provider Issues

Problem: Hosting provider doesn’t support SSHSolutions:
  • Upgrade to a hosting plan with shell access
  • Switch to a provider that supports SSH
  • Use alternative deployment methods (FTP, Git hooks)
  • Contact hosting support for SSH enablement
Problem: Required tools not availableSolutions:
  • Verify PHP version meets requirements (7.4+)
  • Check if Composer is installed
  • Contact hosting provider to install missing tools
  • Use hosting provider’s one-click installers

​
Next Steps After Linking

Once your shared hosting is successfully linked with Loupp:

Connect Repository

Link your Git repository for automated deployments

Configure Environment

Set up environment variables and configuration files

Deploy Application

Perform your first deployment to verify everything works

Set Up Monitoring

Configure logging and monitoring for your application
⌘I