36ae41a4f1
Root Cause Analysis: - Generic error handling in main-axios.ts was stripping fileNotFound data from 404 responses - Windows were being created before error detection, showing empty editors with "File is empty" - Error message translation was not properly detecting various file-not-found scenarios Core Fixes: 1. **Preserve 404 Error Data:** Modified readSSHFile to preserve fileNotFound information - Create custom error object for 404 responses - Set isFileNotFound flag to bypass generic error handling - Maintain original response data for proper error detection 2. **Enhanced Error Detection:** Improved FileWindow error detection logic - Check for custom isFileNotFound flag - Detect multiple error message patterns: "File not found", "Resource not found" - Handle both backend-specific and generic error formats 3. **Prevent Empty Windows:** Auto-close window when file cleanup occurs - Call closeWindow(windowId) immediately after cleanup - Return early to prevent showing empty editor - Show only the cleanup notification toast Behavior Changes: - **Before:** Opens empty editor + shows "Server error occurred" + displays "File is empty" - **After:** Shows "File removed from recent/pinned lists" + closes window immediately - **Result:** Clean, user-friendly experience with automatic cleanup Technical Details: - Enhanced readSSHFile error handling for 404 status codes - Improved error pattern matching for various "not found" scenarios - Window lifecycle management during error states - Preserved backward compatibility for other error types 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Repo Stats
English |
中文
Achieved on September 1st, 2025
Top Technologies
If you would like, you can support the project here!
Overview
Termix is an open-source, forever-free, self-hosted all-in-one server management platform. It provides a web-based solution for managing your servers and infrastructure through a single, intuitive interface. Termix offers SSH terminal access, SSH tunneling capabilities, and remote file editing, with many more tools to come.
Features
- SSH Terminal Access - Full-featured terminal with split-screen support (up to 4 panels) and tab system
- SSH Tunnel Management - Create and manage SSH tunnels with automatic reconnection and health monitoring
- Remote File Editor - Edit files directly on remote servers with syntax highlighting, file management features ( uploading, removing, renaming, deleting files)
- SSH Host Manager - Save, organize, and manage your SSH connections with tags and folders
- Server Stats - View CPU, memory, and HDD usage on any SSH server
- User Authentication - Secure user management with admin controls and OIDC and 2FA (TOTP) support
- Modern UI - Clean desktop/mobile friendly (in progress) interface built with React, Tailwind CSS, and Shadcn
- Languages - Built-in support for English and Chinese
- Improved Platform Support - Now includes an installable Electron app (in progress) for desktop, with a dedicated mobile app also planned.
Planned Features
See Projects. If you are looking to contribute, see Contributing,
Installation
Visit the Termix Docs for more information on how to install Termix. Otherwise, view a sample docker-compose file here:
services:
termix:
image: ghcr.io/lukegus/termix:latest
container_name: termix
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- termix-data:/app/data
environment:
PORT: "8080"
volumes:
termix-data:
driver: local
Pre-built binaries are now available for download, including a Windows installer/portable app and a Linux portable app ( built with Electron). See Docs for details. A native iOS/Android app is planned.
Support
If you need help with Termix, you can join the Discord server and visit the support channel. You can also open an issue or open a pull request on the GitHub repo.
Show-off
License
Distributed under the Apache License Version 2.0. See LICENSE for more information.