https://github.com/clusterzx/intellissh
A secure and user-friendly web app for managing Linux servers with Artifical Intelligence via SSH—right from your browser.
https://github.com/clusterzx/intellissh
ai ssh webssh
Last synced: 5 months ago
JSON representation
A secure and user-friendly web app for managing Linux servers with Artifical Intelligence via SSH—right from your browser.
- Host: GitHub
- URL: https://github.com/clusterzx/intellissh
- Owner: clusterzx
- License: mit
- Created: 2025-05-31T19:16:14.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-06-14T17:47:32.000Z (8 months ago)
- Last Synced: 2025-06-23T00:50:14.846Z (8 months ago)
- Topics: ai, ssh, webssh
- Language: JavaScript
- Homepage:
- Size: 6.02 MB
- Stars: 107
- Watchers: 1
- Forks: 5
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📡 IntelliSSH
A secure and user-friendly web app for managing Linux servers with Artifical Intelligence via SSH—right from your browser + SFTP Browser in Terminal.
Support this project:
[](https://www.patreon.com/c/clusterzx)
[](https://www.paypal.com/paypalme/bech0r)
[](https://www.buymeacoffee.com/clusterzx)
[](https://ko-fi.com/clusterzx)
## IMPORTANT INFORMATION REGARDING CREDENTIALS:
The default Admin credentials are shown on first startup in the Docker Logs!
Sample:
```
========================================================
INITIAL ADMIN ACCOUNT CREATED
Username: admin
Password: b99c192f24ba9e4f
Please log in and change this password immediately!
========================================================
```
## 🚀 Overview
IntelliSSH helps system administrators and developers access and control remote Linux servers with:
- Browser-based SSH access (via xterm.js)
- Full SFTP Client in Terminal (Download, Upload (Files/Folder), Create Folder, Delete)
- Centralized and secure session management
- Support for password and key-based auth
- Real-time terminal via WebSocket
- AI-powered assistance (OpenAI or Ollama)
- Responsive UI with dark mode
## 🔐 Key Features
- **Authentication**: Secure login with JWT and bcrypt
- **Credential Management**: Securely manage credentials for SSH session connections.
- **Two-Factor Authentication (TOTP)**: Enhance security with Time-based One-Time Password verification.
- **SSH Sessions**: Create, edit, test, and connect
- **Terminal**: Full emulation, copy/paste, resize
- **AI Assistant**: Context-aware help and suggestions
- **Security**: Encrypted credential storage, rate limiting
- **Deployment**: Local or Docker-based deployment
## 🧱 Architecture
```
Frontend (Vue) <--> Backend (Express)
↕ ↕
WebSocket SSH2, LLM, DB
```
## ⚡ Quick Start
### 🧪 Development
```bash
git clone https://github.com/clusterzx/intellissh
cd intellissh
# Backend
cd server && npm install && cp .env.example .env && npm run dev
# Frontend (new terminal)
cd client && npm install && npm run dev
```
- **Web**: [http://localhost:8080](http://localhost:8080)
- **API**: [http://localhost:3000](http://localhost:3000)
---
### 🚀 Production (Docker)
#### Run with port mapping (adjust ports as needed)
```bash
docker run -d -p 8080:3000 --name intellissh clusterzx/intellissh:latest
```
#### Run with volume mounts for persistence
```bash
docker run -d \
-p 8080:3000 \
-v $(pwd)/data:/app/server/data \
--name intellissh \
clusterzx/intellissh:latest
```
#### Docker Compose
```yaml
services:
intellissh:
image: clusterzx/intellissh:latest
container_name: intellissh
ports:
- 8080:3000
volumes:
# Mount for persistent backend data (SQLite DB, session info, etc.)
- ./data:/app/server/data
restart: unless-stopped
```
---
## 📚 Documentation
- **API**: REST endpoints for auth, sessions, and settings
- **WebSocket**: Real-time terminal and LLM communication
- **Usage**: Add SSH sessions, connect, manage profile, enable AI assistant
## 🛠 Tech Stack
- Vue 3 + TailwindCSS
- Express.js + SQLite
- SSH2, Socket.IO, xterm.js
- OpenAI / Ollama for AI
- Docker for deployment
## 📌 Roadmap Highlights
- SFTP file browser ✅
- Activity logging ⏳
- Multi-user session sharing ⏳
- Bulk operations & SSH key manager ⏳
- i18n and mobile apps ⏳
## 🤝 Contributing
We welcome contributions! Please fork the repo, create a branch, and submit a PR.
## 🛡️ License
MIT License — see [LICENSE](./LICENSE) for details.
---
> **Note**: IntelliSSH handles SSH credentials—secure your deployment appropriately.