# tuxee (agent0ai/tuxee)

> Tuxee is a tiny Debian-based Linux container with a web interface for files and persistent terminals, aimed at server admins and AI agents.

- GitHub: https://github.com/agent0ai/tuxee
- GitHub.Locker page: https://github.locker/agent0ai/tuxee
- Stars: 326
- Language: JavaScript
- Last push: 2026-11-02

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**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.


---

## README (checked against GitHub 2026-11-04)

Source: https://github.com/agent0ai/tuxee/blob/main/README.md

<p align="center">
  <a href="https://youtu.be/RdexB39ISjg" target="_blank" rel="noopener noreferrer" title="Tuxee - the most convenient Linux for servers and agents.">
    <img src=".github/resources/tuxee-video-preview.webp" alt="Tuxee - the most convenient Linux for servers and agents." width="800">
  </a>
</p>

# Tuxee - the most convenient Linux for servers and agents.

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

<h4>Great for admins, perfect for AI agents.</h3>

## Highlights

<table>
  <tr>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/lightweight-metrics.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/lightweight-metrics-thumb.webp" alt="Tuxee metrics infographic: 0% CPU, 20 MB RAM, 60 MB Docker image and 1 second startup time" width="100%">
      </a>
    </td>
    <td width="50%" valign="middle">
      <h3>Lightweight and fast</h3>
      <p>Based on Debian slim.<br>Core written in Go.<br>No bloat.</p>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="middle">
      <h3>Headless with web interface automatically exposed</h3>
      <p>Log in as a real Linux user.<br>No config needed.</p>
    </td>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/linux-user-login.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/linux-user-login-thumb.webp" alt="Tuxee login with a Linux username and password" width="240">
      </a>
    </td>
  </tr>
  <tr>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/file-managers-persistent-terminals.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/file-managers-persistent-terminals-thumb.webp" alt="File managers and persistent terminals running htop and Codex, alongside Chromium and Visual Studio Code GUI apps" width="100%">
      </a>
    </td>
    <td width="50%" valign="middle">
      <h3>File managers and <b>(persistent!)</b> terminals. That's all you need.</h3>
      <p>Easy access to server files and terminals that don't die when you log out.</p>
      <p>Great for system admins, perfect for running agents.</p>
      <p><strong>Oh, and GUI apps work great too!</strong></p>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="middle">
      <h3>Smooth and natural UX</h3>
      <ul>
        <li>Workspace tabs to organize your work</li>
        <li>Drag and resize windows with grid snapping</li>
        <li>Convenient auto layouts prioritizing terminals or file browsers</li>
      </ul>
    </td>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/workspaces-grid-layouts.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/workspaces-grid-layouts-thumb.webp" alt="Dragging a file manager into a snapped grid layout beside a terminal running Spynel" width="100%">
      </a>
    </td>
  </tr>
  <tr>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/drag-drop-uploads.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/drag-drop-uploads-thumb.webp" alt="Files dragged from a computer onto a terminal's Upload and paste target" width="100%">
      </a>
    </td>
    <td width="50%" valign="middle">
      <h3>Drag 'n' drop anything</h3>
      <p>Drag files between windows to move or copy them, or paste their paths into terminals.</p>
      <p>Drag files from your computer into the interface to upload them, or drop them directly into terminals.</p>
      <p>Give your agents files with ease.</p>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="middle">
      <h3>Edit and view</h3>
      <p>Built-in file editor with syntax highlighting and large file support.</p>
      <p>Built-in media viewer.</p>
    </td>
    <td width="50%" align="center" valign="middle">
      <a href=".github/resources/screenshots/editor-media-viewer.webp" target="_blank" rel="noopener noreferrer">
        <img src=".github/resources/screenshots/editor-media-viewer-thumb.webp" alt="Markdown syntax highlighting in the file editor above an image in the media viewer" width="100%">
      </a>
    </td>
  </tr>
</table>

## Quick start

**Recommended: run the tiny Docker image with zero configuration.**

```sh
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](docs/guide.md#docker) 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:**

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

[Manual installation and building from source](docs/install.md)

## Resources

- [Docker setup](docs/guide.md#docker)
- [User and developer guide](docs/guide.md)
- [Updates, releases and repository setup](docs/releases.md)
- [Startup scripts](docker/init/README.md)
- [Optional configuration](docs/guide.md#optional-configuration)
- [License (MIT)](LICENSE)
- [Contribution policy](CONTRIBUTING.md)
- [Third-party notices](THIRD_PARTY_NOTICES.md)

---

<p align="center">
  Made by <a href="https://agent-zero.ai">Agent Zero</a>
</p>
<p align="center">
  <a href="https://agent-zero.ai">Website</a> ·
  <a href="https://github.com/agent0ai">GitHub</a> ·
  <a href="https://discord.gg/B8KZKNsPpj">Discord</a> ·
  <a href="https://x.com/Agent0ai">X</a> ·
  <a href="https://www.youtube.com/@AgentZeroFW">YouTube</a> ·
  <a href="https://github.com/sponsors/agent0ai">Sponsor</a>
</p>