Installation¶

desto can be installed using Docker, uv, or pip.

⚡ 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:

Clone the repository and go to it's main directory

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

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

🚀 Essential Docker & Docker Compose Commands

# 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

🖥️ CLI & 📊 Dashboard Installation with `uv` or `pip`¶

Requirements¶

Python 3.11+
tmux
at (for scheduling features)

Installation Steps¶

Install tmux and at
Instructions for different package managers
- **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`.
Install desto
Installation Steps
- (Recommended) With [uv](https://github.com/astral-sh/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`](https://docs.astral.sh/uv/getting-started/installation/): 1. [Install `uv`](https://docs.astral.sh/uv/getting-started/installation/) 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
```
Run the Application
```
desto
```

🎉 Done!
Open your browser and visit: http://localhost:8809 🚀

Global `desto` Installation as a `uv` Tool (includes CLI)¶

# Install desto CLI globally
uv tool install desto

# Or install from source
cd /path/to/desto
uv tool install . --force

This installs two executables: - desto - Web dashboard
- desto-cli - Command-line interface