https://github.com/phantom8015/specters
A linux web interface
https://github.com/phantom8015/specters
cockpit connection docker express gui hosting interface linux node server ssh terminal ubuntu web websocket
Last synced: 6 months ago
JSON representation
A linux web interface
- Host: GitHub
- URL: https://github.com/phantom8015/specters
- Owner: Phantom8015
- License: mit
- Created: 2025-07-18T21:45:49.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-08-10T05:07:35.000Z (6 months ago)
- Last Synced: 2025-08-10T07:07:46.811Z (6 months ago)
- Topics: cockpit, connection, docker, express, gui, hosting, interface, linux, node, server, ssh, terminal, ubuntu, web, websocket
- Language: JavaScript
- Homepage: https://specters.dev
- Size: 201 KB
- Stars: 51
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Specters
Specters is a powerful web-based file explorer with terminal integration, system monitoring, and modern UI. Built with Node.js and designed for efficiency and ease of use.
Note: This has not been tested outside of Ubuntu/Debian. Stability is not guaranteed if you are not using them.
## Features
- **File Management** - Browse, upload, download, and manage files with drag-and-drop support
- **Terminal Integration** - Built-in web terminal for running commands directly from the browser
- **System Monitoring** - Real-time CPU, memory, and GPU usage monitoring
- **File Preview** - Preview text files, images, and media directly in the browser
- **Fast & Responsive** - Built with modern web technologies for optimal performance
- **Modern UI** - Clean, intuitive interface inspired by modern design principles
## Installing
### Docker (Recommended)
The easiest way to run Specters is using Docker:
#### Using Docker Compose
Run commands as root if you experience permission issues.
```bash
curl -o docker-compose.yml https://raw.githubusercontent.com/Phantom8015/Specters/main/docker-compose.yml
nano docker-compose.yml
docker-compose up -d
```
#### Using Docker Run
**Basic usage:**
```bash
docker run -p 3000:3000 phantom8016/specters:latest
```
**Production setup with volume mounts:**
```bash
docker run -d \
--name specters \
-p 3000:3000 \
-v /home:/app/managed/home:rw \
-v /var/log:/app/managed/logs:ro \
--restart unless-stopped \
phantom8016/specters:latest
```
### Traditional Installation
#### Quick Install Script
**On your server:**
```bash
curl -fsSL https://raw.githubusercontent.com/Phantom8015/Specters/main/install.sh | bash
```
**On your PC:**
1. **Open your browser (on your pc)**
Navigate to `http://:3000`
## Manual Installation
### Requirements
- **Operating System**: Linux (on the server)
- **Node.js**: Version 16 or higher
- **Git**: For cloning the repository
- **NPM**: For installing dependencies
### On your server:
1. **Clone the repository**
```bash
git clone https://github.com/Phantom8015/Specters.git
cd Specters
```
2. **Install dependencies**
```bash
npm i
```
3. **Start Specters**
```bash
npm start
```
### On your PC:
1. **Open your browser**
Navigate to `http://:3000`
## Security Considerations
- The application allows file system access - ensure proper firewall rules
- Run behind a reverse proxy (nginx) for production
- Consider implementing authentication for sensitive environments
- Regularly update dependencies for security patches
## Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is open source and available under the [MIT License](LICENSE).
## Issues & Support
- **Issues**: [GitHub Issues](https://github.com/Phantom8015/Specters/issues)
- **Contact**: [Phantom8015](https://github.com/Phantom8015)