Skip to content

betaversionio/stacklane

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

StackLane

A modern, all-in-one web platform for comprehensive server management

StackLane transforms how you interact with your remote servers by providing a powerful browser-based interface that combines terminal access, file management, performance monitoring, cloud storage integration, and remote desktop capabilitiesโ€”all in one seamless application. No more juggling multiple tools and terminal windows.

Version License

StackLane Interface

Why StackLane?

  • ๐Ÿš€ Quick Start: Launch with a single npx commandโ€”no complex setup required
  • ๐ŸŒ Browser-Based: Access your servers from anywhere without installing SSH clients
  • ๐ŸŽจ Modern UI: Intuitive, OS-like interface that feels familiar and powerful
  • ๐Ÿ” Secure: Built on industry-standard SSH and SFTP protocols
  • ๐Ÿ“ฆ All-in-One: Terminal, files, monitoring, storage, and desktop in one place
  • ๐Ÿ”ง Developer-Friendly: Built with modern web technologies (React, NestJS, TypeScript)

Quick Start

npx stacklane

Or install globally:

npm i -g stacklane
stacklane

Opens a browser UI at http://localhost:3721 where you can manage SSH connections, browse files via SFTP, open terminals, and monitor server stats.

CLI Options

stacklane [options]

Options:
  -p, --port <number>  Port to run on (default: 3721)
  --no-open            Don't open browser automatically
  -V, --version        Output version number
  -h, --help           Display help

Features

๐Ÿ–ฅ๏ธ Interactive Terminal

A fully-featured SSH terminal powered by xterm.js that brings the power of your remote servers directly to your browser. No need for separate terminal applicationsโ€”everything runs seamlessly in your web browser with full support for colors, cursor movements, and special characters.

Terminal

Key Features:

  • โœจ True SSH terminal experience with xterm.js
  • ๐ŸŽจ Multiple pre-configured color themes (Dracula, Monokai, Nord, Tokyo Night, and more)
  • ๐Ÿ”ค Customizable fonts and text sizes for optimal readability
  • โŒจ๏ธ Full keyboard support including special keys and shortcuts
  • ๐Ÿ“ฑ Responsive design that works on any screen size
  • ๐Ÿ”„ Real-time bidirectional communication via WebSockets

App Catalog - Deploy popular self-hosted applications with a single click:

App Catalog

Browse and install from a curated collection of self-hosted apps including:

  • ๐Ÿ—„๏ธ Databases: Supabase, PocketBase, Metabase
  • ๐Ÿ“ CMS: WordPress, Ghost, Directus
  • โ˜๏ธ Cloud Storage: Nextcloud, MinIO
  • ๐Ÿ” Security: Vaultwarden (Bitwarden), Authentik
  • ๐Ÿ› ๏ธ DevOps: Gitea, Portainer, n8n
  • And many more...

Each app comes with pre-configured installation scripts that handle all dependencies and setup automatically.

Terminal Customization - Personalize your terminal experience:

Terminal Appearance

  • ๐ŸŽจ 14+ Color Themes: From classic dark themes to modern palettes
  • ๐Ÿ”ค Font Selection: Choose from popular monospace fonts (JetBrains Mono, Fira Code, Cascadia Code, etc.)
  • ๐Ÿ“ Adjustable Text Size: From 12px to 20px for perfect readability
  • ๐Ÿ’พ Persistent Settings: Your preferences are saved and applied automatically

๐Ÿ“ Advanced File Manager

A powerful SFTP-based file manager that lets you browse, upload, download, edit, and manage files on your remote servers with an intuitive drag-and-drop interface. Think of it as a modern file explorer for your servers.

File Manager

Capabilities:

  • ๐Ÿ“‚ Browse Directories: Navigate your server's file system with a familiar folder tree
  • โฌ†๏ธ Upload Files: Drag and drop files directly from your computer
  • โฌ‡๏ธ Download Files: Download individual files or entire folders
  • โœ๏ธ Edit Files: Built-in text editor for quick file modifications
  • ๐Ÿ—‘๏ธ File Operations: Create, rename, delete, move, and copy files
  • ๐Ÿ” Search: Quickly find files and folders
  • ๐Ÿ‘๏ธ Preview: View file contents without downloading
  • ๐Ÿ“Š File Details: See permissions, size, modification dates, and ownership
  • ๐Ÿ”’ Permissions Management: Change file and folder permissions
  • ๐Ÿš€ Fast Performance: Optimized for handling large directories

๐Ÿ“Š Real-Time Server Monitor

Get instant visibility into your server's health and performance with comprehensive monitoring dashboards. Track CPU usage, memory consumption, disk space, and network activityโ€”all updating in real-time.

Monitor

Monitoring Metrics:

  • ๐Ÿ”ฅ CPU Usage: Real-time processor utilization with load averages
    • Current usage percentage
    • CPU model and core count
    • Load averages (1m, 5m, 15m)
  • ๐Ÿ’พ Memory Stats: RAM and swap usage monitoring
    • Total, used, and free memory
    • Memory usage percentage
    • Swap utilization
  • ๐Ÿ’ฟ Disk Information: Storage capacity and usage for all mounted filesystems
    • Total, used, and free space
    • Filesystem types and mount points
    • Usage percentages for each partition
  • ๐ŸŒ Network Activity: Track data transfer and bandwidth
    • Real-time network traffic
    • Upload and download speeds
    • Network interface statistics

Perfect for identifying performance bottlenecks, planning upgrades, and ensuring your servers run smoothly.

๐Ÿ—„๏ธ Cloud Storage Management

Seamlessly integrate and manage S3-compatible storage buckets from multiple providers. Upload, download, and organize your cloud files without leaving StackLane.

Storage

Supported Providers:

  • ๐ŸŸ  AWS S3: Amazon's industry-standard object storage
  • โ˜๏ธ Cloudflare R2: Zero egress fees, S3-compatible storage
  • ๐Ÿ”ท DigitalOcean Spaces: Simple, scalable object storage
  • ๐ŸŒŠ Backblaze B2: Affordable cloud storage
  • And any S3-compatible storage service

Features:

  • ๐Ÿ“ฆ Multiple Credentials: Manage connections to multiple storage providers
  • ๐Ÿ—‚๏ธ Bucket Management: Create, list, and manage buckets across all providers
  • ๐Ÿ“ค File Operations: Upload, download, and delete objects
  • ๐Ÿท๏ธ Metadata Support: View and manage object metadata
  • ๐Ÿ”— Pre-signed URLs: Generate temporary shareable links
  • ๐Ÿ“Š Usage Stats: Monitor storage consumption
  • ๐Ÿ”’ Secure Connections: All operations use encrypted HTTPS
  • ๐ŸŽฏ Default Buckets: Set default buckets for quick access

๐Ÿ” Secure Keychain

Centralized SSH key management that eliminates the need to enter passwords repeatedly. Store your SSH private keys securely and use them across all your server connections with one-click authentication.

Keychain

Key Management:

  • ๐Ÿ”‘ Store Multiple Keys: Add and manage all your SSH keys in one place
  • ๐Ÿ“ Key Descriptions: Label your keys for easy identification
  • ๐Ÿ”’ Secure Storage: Keys are encrypted and stored locally
  • โšก Quick Selection: Choose keys when adding new server connections
  • ๐Ÿ”„ Reusable Keys: Use the same key across multiple servers
  • โœ… Key Validation: Automatic format checking for RSA, ED25519, ECDSA keys
  • ๐Ÿ“‹ Easy Import: Paste your existing private keys
  • ๐ŸŽฏ Passphrase Support: Works with both encrypted and unencrypted keys

Benefits:

  • โœจ Passwordless Authentication: No more typing passwords for every connection
  • ๐Ÿ›ก๏ธ Enhanced Security: More secure than password-based authentication
  • โฑ๏ธ Time Saving: Connect to servers instantly
  • ๐Ÿ” Best Practices: Encourages SSH key usage over passwords

๐Ÿ–ผ๏ธ Remote Desktop Access

Access your server's graphical desktop environment directly from your browser using noVNC. Run GUI applications, configure desktop settings, and interact with your server visuallyโ€”no separate VNC client needed.

OS Desktop

Desktop Features:

  • ๐Ÿ–ฅ๏ธ Full Desktop Access: Complete graphical interface in your browser
  • ๐ŸŽฎ Mouse & Keyboard: Full input support for seamless interaction
  • ๐Ÿ“ฑ Responsive: Works on desktop, tablet, and mobile devices
  • ๐Ÿ”ง Multi-Window Support: Open and manage multiple applications
  • ๐ŸŒ Web Browser Integration: Built-in browser for server administration
  • ๐ŸŽจ Theme Support: Respects your server's desktop theme and settings
  • ๐Ÿ“Š System Monitoring: Desktop environment with system monitors
  • ๐Ÿ”Œ Application Launching: Run any installed GUI application

Use Cases:

  • Configure server software with GUI installers
  • Access web-based admin panels running on localhost
  • Run desktop applications that require graphical interface
  • Visual file management with desktop file managers
  • Database administration with GUI tools
  • Development with IDEs and visual editors

Perfect for when you need more than just a terminal and want the full desktop experience of your remote server.

Development

Prerequisites

  • Node.js 18+
  • pnpm 9+

Setup

git clone https://github.com/betaversionio/stacklane.git
cd StackLane
pnpm install

Dev Mode

Run the server and web frontend with hot reload:

pnpm dev

Or run them separately:

pnpm dev:server   # NestJS server on :3721
pnpm dev:web      # Vite dev server on :5173 (proxies API to :3721)

Project Structure

packages/
  shared/    - Shared TypeScript types (API, connection, stats, etc.)
  server/    - NestJS backend (SSH, SFTP, WebSocket terminal, stats)
  web/       - React frontend (Vite + Tailwind CSS v4 + Radix UI)
  cli/       - CLI entry point + npm package bundling

Build

pnpm build          # Build all packages
pnpm build:pkg      # Build + bundle into publishable CLI package

Test Locally

pnpm build:pkg      # Full build
pnpm link:cli       # Link globally
stacklane           # Run it
pnpm unlink:cli     # Unlink when done

Publish

pnpm publish:dry    # Dry run
pnpm publish:npm    # Publish to npm

Tech Stack

Layer Technology
Frontend React 19, TypeScript, Tailwind CSS v4, Radix UI
Terminal xterm.js
Backend NestJS, Express, ssh2, WebSocket (ws)
Database SQLite (sql.js) + Drizzle ORM
Build Turborepo, pnpm workspaces, Vite
CLI Commander.js

License

MIT

About

Browser-based OS-like UI for managing remote servers via SSH

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors