Skip to main content

Running Shellngn Pro with Docker

Shellngn Pro is a powerful web-based application that provides secure remote access to servers through SSH, SFTP, Telnet, RDP and VNC clients. This guide will walk you through setting up and running Shellngn Pro using Docker.

Features

  • 🔒 Secure web-based SSH, SFTP
  • 🖥️ Remote Desktop support via RDP and VNC
  • 📂 Built-in file management and editor
  • 📑 Tabbed multi-session interface

Prerequisites

Before getting started, make sure you have:

  • Docker installed on your system
  • Basic understanding of Docker commands
  • Port 8080 available (or another port of your choice)
  • Sufficient disk space (~100MB)

Basic Installation

1. Pull the Docker Image

docker pull shellngn/pro

2. Run the Container

docker run --name shellngn-pro \
--mount source=shellngn-data,target=/home/node/server/data \
-p 8080:8080 -e HOST=0.0.0.0 shellngn/pro:latest

3. Access the Application

Visit http://localhost:8080 to login to the system.

Environment Variables

VariableDefaultDescription
PORT8080Web application listening port
HOST0.0.0.0Host to listen on
CORS*Cross-origin resource sharing origin
BASE_URL/Base URL for the application
TLS_CERTnoneSSL certificate filename
TLS_KEYnoneSSL private key filename
RESET_USERnoneReset user password (e.g., RESET_USER=admin:12345)

Maintenance and Cleanup

Basic Container Management

# Stop the container
docker stop shellngn-pro

# Start the container
docker start shellngn-pro

# Remove the container
docker rm shellngn-pro

Complete Cleanup

To completely remove Shellngn Pro and all its data:

# Stop and remove the container
docker stop shellngn-pro
docker rm shellngn-pro

# Remove the Docker image
docker rmi shellngn/pro

# Remove the data volume
docker volume rm shellngn-data

One-Line Cleanup Command

docker stop shellngn-pro && docker rm shellngn-pro && docker rmi shellngn/pro && docker volume rm shellngn-data

Troubleshooting

  • If port 8080 is already in use, modify the port mapping in the docker run command
  • Check container logs: docker logs shellngn-pro
  • For password resets, use the RESET_USER environment variable
  • Verify volume mounting if data persistence issues occur

For more information, visit: