/TasmoAdmin

TasmoAdmin is an administrative platform for devices flashed with Tasmota

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

TasmoAdmin

Main codecov Discord GitHub release GitHub contributors GitHub stars GitHub forks Github all releases GitHub license bootstap php

TasmoAdmin (previously SonWEB) is an administrative platform for devices flashed with Tasmota. It can run standalone, as a container, or as a Home Assistant addon.

Features

  • Login protected
  • Multi update process
    • Select devices to update
    • Automatic mode downloads latest firmware bin from Tasmota OTA site
  • Show device information
  • Mobile Responsive (Bootstrap4)
    • SCSS & Minified
  • Config devices
  • Self-update function for TasmoAdmin (disabled for Docker installs)
  • NightMode (Enable/Disable/Auto) in settings
  • AutoScan to find Tasmota Devices
  • Support for multiple sensors
  • Send Command to selected Devices

Supported Platforms

  • Apache2 and Nginx
  • Docker by @RaymondMouthaan
    • unRaid by @digiblur
  • IOCage (FreeNAS) by @tprelog

YouTube

YouTube Video by DrZzs
by DrZzs

Setup

Docker

TasmoAdmin is available as a Docker image on GitHub packages.

This is a Linux Alpine based image with Nginx and PHP 8.2 installed. It supports multiple architectures, amd64 (i.e. Synology DSM), arm (i.e. Raspberry PI3) and arm64 (i.e. Pine64). Check out the Guide for TasmoAdmin on Docker for setup instructions.

This is the recommended way to get up and running.

Home Assistant Addon

TasmoAdmin is also available as Home Assistant addon, please refer to Home Assistant - addon TasmoAdmin for more information.

Using a Web Server

TasmoAdmin should run on any webserver that supports PHP 8.1+

Check the guides on the Wiki for more information.

Configuration

Some environment variables are configured to allow easier customisation of the application

  • TASMO_DATADIR - Path where to store data. If not provided defaults to ./tasmoadmin/data
  • TASMO_BASEURL - Customise the base URL for the application

Development

Provided is a docker-compose setup to ease getting started.

Simply run:

make dev

Then visit http://localhost:8000

Persistent storage within this setup is located in the .storage folder.

Translations

We use Transifex to maintain translations of this project. If you are not familiar with this service, you can read Transifex Documentation to get started.

Add or update translations

Here are steps to translate the extension to a specific language.

  1. Join our team on Transifex.
  2. Translate resources using Transifex web interface.

Support

JetBrains Logo (Main) logo.

This project supported by JetBrains through their Licenses for Open Source program.