Skip to content
Klutch.sh Docs

Deploying Tasmota

Introduction

TasmoAdmin is a web-based administration tool for managing Tasmota-flashed IoT devices. Tasmota is popular open-source firmware for ESP8266/ESP32 devices, and TasmoAdmin provides a centralized dashboard for monitoring and controlling all your smart devices.

Key highlights of TasmoAdmin:

  • Central Dashboard: Manage all Tasmota devices from one place
  • Device Discovery: Automatic discovery of Tasmota devices on your network
  • Bulk Actions: Perform actions on multiple devices simultaneously
  • Firmware Updates: Update Tasmota firmware across devices
  • Device Status: Monitor power consumption, uptime, and more
  • Configuration Backup: Backup and restore device configurations
  • Scheduling: Set timers and schedules for devices
  • Grouping: Organize devices into groups
  • Dark Mode: Easy on the eyes interface
  • Self-Hosted: Complete control over your IoT management

This guide walks through deploying TasmoAdmin on Klutch.sh using Docker.

Why Deploy TasmoAdmin on Klutch.sh

Deploying TasmoAdmin on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh automatically detects your Dockerfile and builds TasmoAdmin without complex orchestration.

Persistent Storage: Attach persistent volumes for device configurations.

HTTPS by Default: Secure access to your IoT dashboard from anywhere.

GitHub Integration: Connect your configuration repository for automatic redeployments.

Note: TasmoAdmin needs network access to your Tasmota devices. Consider VPN or network configuration for remote access to local devices.

Prerequisites

Before deploying TasmoAdmin on Klutch.sh, ensure you have:

  • A Klutch.sh account
  • A GitHub account with a repository for your TasmoAdmin configuration
  • Basic familiarity with Docker and containerization concepts
  • Tasmota devices on your network

Deploying TasmoAdmin on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile for TasmoAdmin:

    FROM ghcr.io/tasmoadmin/tasmoadmin:latest
    

    ENV TZ=UTC
    ENV PUID=1000
    ENV PGID=1000
    

    EXPOSE 80
    

    VOLUME ["/data"]

    Push to GitHub

    Initialize and push your repository to GitHub with your Dockerfile.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    In the deployment settings:

    • Select HTTP as the traffic type
    • Set the internal port to 80

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    TZYour timezone (e.g., America/New_York)
    PUID1000
    PGID1000

    Attach Persistent Volumes

    Add the following volumes:

    Mount PathRecommended SizePurpose
    /data1 GBDevice data and configuration

    Deploy Your Application

    Click Deploy to start the build process.

    Access TasmoAdmin

    Once deployment completes, access TasmoAdmin at your app URL.

Configuration

Adding Devices

Add Tasmota devices manually:

  1. Click Add Device
  2. Enter the device IP address
  3. Set device name (optional)
  4. Click Save

Auto-Discovery

Discover devices automatically:

  1. Navigate to Device Discovery
  2. Scan your network
  3. Add discovered devices

Note: Auto-discovery requires network access to your local network.

Device Groups

Organize devices into groups:

  1. Navigate to Groups
  2. Create a new group
  3. Add devices to the group
  4. Perform bulk actions on groups

Firmware Updates

Update Tasmota firmware:

  1. Select devices to update
  2. Choose firmware version
  3. Start the update process
  4. Monitor progress

Additional Resources

Conclusion

Deploying TasmoAdmin on Klutch.sh gives you a central dashboard for managing Tasmota IoT devices with automatic builds, persistent storage, and secure HTTPS access. Monitor and control your smart devices from anywhere.