tuxee README

The project's README from github.com/agent0ai/tuxee. As one markdown file: README.md.

Tuxee - the most convenient Linux for servers and agents.

Tuxee - the most convenient Linux for servers and agents.

A tiny Debian Linux container with a superb web interface for files and (persistent!) terminals. Also available as a standalone web interface for existing Linux servers.

Great for admins, perfect for AI agents.

Highlights

Tuxee metrics infographic: 0% CPU, 20 MB RAM, 60 MB Docker image and 1 second startup time

Lightweight and fast

Based on Debian slim.
Core written in Go.
No bloat.

Headless with web interface automatically exposed

Log in as a real Linux user.
No config needed.

 Tuxee login with a Linux username and password
File managers and persistent terminals running htop and Codex, alongside Chromium and Visual Studio Code GUI apps

File managers and (persistent!) terminals. That's all you need.

Easy access to server files and terminals that don't die when you log out.

Great for system admins, perfect for running agents.

Oh, and GUI apps work great too!

Smooth and natural UX

  • Workspace tabs to organize your work
  • Drag and resize windows with grid snapping
  • Convenient auto layouts prioritizing terminals or file browsers
 Dragging a file manager into a snapped grid layout beside a terminal running Spynel
Files dragged from a computer onto a terminal's Upload and paste target

Drag 'n' drop anything

Drag files between windows to move or copy them, or paste their paths into terminals.

Drag files from your computer into the interface to upload them, or drop them directly into terminals.

Give your agents files with ease.

Edit and view

Built-in file editor with syntax highlighting and large file support.

Built-in media viewer.

 Markdown syntax highlighting in the file editor above an image in the media viewer

Quick start

Recommended: run the tiny Docker image with zero configuration.

docker run -p 80:80 -p 443:443 -e ROOT_PASSWORD='your-password' agent0ai/tuxee

The app is available on HTTP 80 and HTTPS 443. Behind Traefik or another HTTPS proxy, forward to container port 80—no Tuxee configuration is needed. See Docker setup for persistence and alternate host ports.

You can use ROOT_PASSWORD_FILE instead of ROOT_PASSWORD to provide file path instead of plain value for the default password.

Or install directly on an existing Linux server:

curl -fsSL https://tuxee.agent-zero.ai/install.sh | sudo sh

Manual installation and building from source

Resources

Made by Agent Zero

Website · GitHub · Discord · X · YouTube · Sponsor

tuxee (agent0ai/tuxee)

Searching Database…

326 ·GitHub
Tuxee
What is this?Tuxee is a tiny Debian-based Linux container with a web interface for files and persistent terminals, aimed at server admins and AI agents.
Is it a full Linux distribution, or something else?It is a slim Debian container rather than a full distribution, and the same web interface can also be installed on an existing Linux server.
How do I get it running?Run the tiny Docker image with zero configuration; it serves on HTTP 80 and HTTPS 443. Alternatively, install it directly on an existing Linux server using the manual installation guide.
Do I need Docker?Docker is the recommended route, but you can skip it and install directly on an existing Linux server.
Is it for sysadmins or for AI agents?Both. It is pitched at admins who want file managers and persistent terminals, and at AI agents that need files and a shell.
What are the persistent terminals good for?They keep running after you log out, so long-running jobs and agent sessions survive when you disconnect from the web interface.
How do I move files in and out?Drag files from your computer into the interface to upload them, or drop them straight into a terminal. You can also drag files between windows to move or copy them.
Does it include a file editor?Yes, a built-in editor with syntax highlighting and large-file support, plus a built-in media viewer.
What are similar projects?cockpit, 1Panel, dockge, ovis, AgentTeams, cadvisor, WindTerm, glances
Which topics is it in?file-manager, remote-access, admin-dashboard, containers, sysadmin, devops, agents, web-app, go, productivity, gui, agent
Creator
agent0ai
Size
13.2 MB
Stars
326
Updated
CommitNov 02Releasev1.0.2Nov 02
Age
14d
Commits · 90 Days