Desto

<p align="center"> <img src="docs/images/logo.png" alt="desto Logo" title="desto Logo" width="300" style="border:2px solid #ccc; border-radius:6px;"/> </p>

desto lets you run and manage your bash and Python scripts in the background (inside tmux sessions) through a simple web dashboard. Launch scripts, monitor their and your system's status, view live logs, and control sessions—all from your browser.

---

The key features are:

• One-click session control: Launch, monitor, and stop tmux sessions from your browser.
• 🐚 Bash & 🐍 Python support: Run both bash (.sh) and Python (.py) scripts seamlessly.
• Script management: Use your existing scripts, write new ones, edit, save, or delete them directly in the dashboard.
• ⭐ Favorite commands: Save, organize, and quickly run your frequently used commands with usage tracking and search.
• Live log viewer: Watch script output in real time and view logs for each session.
• Live system stats: See real-time CPU, memory, and disk usage at a glance.
• Scheduling: Schedule scripts or script chains to launch at a specific date and time.
• Script chaining: Queue multiple scripts to run sequentially in a single session.
• Session history: Redis integration for persistent session tracking and history. See what is Redis →
• Scheduled job control: Manage scheduled jobs with a dedicated table—cancel any scheduled job with a click.
• Session & log cleanup: Clear session history and delete logs for all or selected sessions.
• Notifications: Optional Pushbullet notifications for job/session finishes — set the DESTO_PUSHBULLET_API_KEY environment variable or add the key in Settings to receive desktop/mobile pushes when jobs complete.
• Persistent script & log storage: Scripts and logs are saved in dedicated folders for easy access.
• 🖥️ Command-line interface: Manage sessions, view logs, and control scripts from the terminal with our modern CLI. Learn more →

<strong>🎬 Demo</strong>

<img src="docs/images/desto_demo.gif" alt="Desto Demo" title="Desto in Action" width="700" style="border:2px solid #ccc; border-radius:6px; margin-bottom:24px;"/>

✨ desto Overview

<div align="left"> <details> <summary><strong>👀 Dashboard Overview</strong></summary> <img src="docs/images/dashboard.png" alt="Dashboard Screenshot" title="Desto Dashboard" width="700" style="border:2px solid #ccc; border-radius:6px; margin-bottom:24px;"/> </details> <details> <summary><strong>🚀 Launch your scripts as `tmux` sessions</strong></summary>

When you start desto, it creates desto_scripts/ and desto_logs/ folders in your current directory. Want to use your own locations? Just change these in the settings, or set the DESTO_SCRIPTS_DIR and DESTO_LOGS_DIR environment variables.

Your scripts show up automatically—no setup needed. Both .sh (bash) and .py (Python) scripts are supported with automatic detection and appropriate execution. Ready to launch? Just:

1. Name your tmux session
2. Select one of your scripts
3. (OPTIONAL) edit and save your changes
4. Click "Launch"! 🎬

<img src="docs/images/launch_script.png" alt="Custom Template" title="Launch Script" width="300" style="border:2px solid #ccc; border-radius:6px;"/> </details> <details> <summary><strong>✍️ Write new scripts and save them</strong></summary>

If you want to compose a new script, you can do it right here, or simply just paste the output of your favorite LLM :) Choose between bash and Python templates with syntax highlighting and smart defaults.

<img src="docs/images/write_new_script.png" alt="Custom Template" title="Write New" width="300" style="border:2px solid #ccc; border-radius:6px;"/> </details> <details> <summary><strong>⭐ Favorite Commands</strong></summary>

Save, organize, and quickly run your frequently used commands with usage tracking and search.

<img src="docs/images/favorites.png" alt="Favorites Screenshot" title="Favorite Commands" width="700" style="border:2px solid #ccc; border-radius:6px; margin-bottom:24px;"/> </details> <details> <summary><strong>⚙️ Change settings</strong></summary>

More settings to be added!

<img src="docs/images/settings.png" alt="Custom Template" title="Change Settings" width="300" style="border:2px solid #ccc; border-radius:6px;"/> </details> <details> <summary><strong>📜 View your script's logs</strong></summary> <img src="docs/images/view_logs.png" alt="Custom Template" title="View Logs" width="300" style="border:2px solid #ccc; border-radius:6px;"/> </details> <details> <summary><strong>🌙 Dark Mode</strong></summary>

Switch to dark mode for comfortable viewing in low-light environments.

<img src="docs/images/dark_mode.png" alt="Dark Mode Screenshot" title="Dark Mode" width="700" style="border:2px solid #ccc; border-radius:6px; margin-bottom:24px;"/> </details> </div>

⚡ Quick Start with Docker 🐳

The fastest way to ship desto is by using Docker Compose 🚢

You only need Docker and Docker Compose installed on your machine. If you don't have them yet, you can find installation instructions on the Docker website and Docker Compose documentation (or follow your favorite LLM's instructions 😉).

Start desto in just a few steps:

1. Clone the repository and go to it's main directory

   git clone https://github.com/kalfasyan/desto.git && cd desto
   

2. Start the application with Docker Compose

   docker compose up -d
   

✅ Done! 🎉

You’re all set—your desto dashboard is now running at:
🌐 http://localhost:8809

<details> <summary><strong>🚀 Essential Docker & Docker Compose Commands</strong></summary>

# Start the app in background (Docker Compose)
docker compose up -d

# View logs (Docker Compose)
docker compose logs -f

# Stop and remove services (Docker Compose)
docker compose down

# Rebuild and start (Docker Compose)
docker compose up -d --build

# Run the container directly (plain Docker)
docker run -d -p 8809:8809 \
  -v $PWD/desto_scripts:/app/desto_scripts \
  -v $PWD/desto_logs:/app/desto_logs \
  --name desto-dashboard \
  desto:latest

# View logs (plain Docker)
docker logs -f desto-dashboard

# Stop and remove the container (plain Docker)
docker stop desto-dashboard && docker rm desto-dashboard

</details>

🖥️ CLI & 📊 Dashboard Installation with uv or pip

If you are not familiar with uv, you may visit uv's official website for more information.

uv is a super-fast Python package manager and virtual environment tool, written in Rust. It helps you manage dependencies, create isolated environments, and install packages much faster than traditional tools like pip.

Requirements

• Python 3.11+
• tmux
• at (for scheduling features)

Check pyproject.toml

Installation Steps

1. Install tmux and at

   <details> <summary>Instructions for different package managers</summary>
   • Debian/Ubuntu

     sudo apt install tmux at
     

   • Almalinux/Fedora

     sudo dnf install tmux at
     

   • Arch Linux

     sudo pacman -S tmux at
     

   Note: The at package is required for scheduling features. If you don't plan to use script scheduling, you can skip installing at.

   </details>

2. Install desto

   <details> <summary>Installation Steps</summary>

   • (Recommended) With uv, simply run:

     uv add desto
     

     This will install desto in your project ✅
     Or if you don't have a project yet, you can set up everything with uv:

     1. Install uv by following the instructions on the official site.

     2. Create and set up your project:

        mkdir myproject && cd myproject
        uv init
        uv venv
        source .venv/bin/activate
        uv add desto
        

        Done!

   • With pip:

     pip install desto
     

   </details>

3. Run the Application

   desto
   

🔄 Auto-start on Boot (systemd)

If you want desto to start automatically when your system boots, you can install a systemd service using the CLI. This works for non-Docker installations.

# Install as a user service (recommended)
desto-cli ser