Quickly set up a build environment for Tasmota using Docker
This bash script makes compiling a lot easier without the need to type lengthy commands each time.
compile.sh is intended to run on a linux machine with docker and git installed. If you're missing any of these the script will pop a warning with instructions how to install.
Running the script for the first time will pull the latest blakadder/docker-tasmota container (you can edit the script to use your own docker container), clone the latest Tasmota development branch (you can change to clone the latest stable release version by setting USE_STABLE=1
) inside the script folder and copy platformio_override.ini and user_config_override.h to Tasmota folder.
Running the script with one or more build names (as listed in platformio_tasmota_env.ini) as parameters will compile only those builds regardless of platformio.ini or platformio_override.ini
./compile.sh tasmota-sensors tasmota-minimal
compiles both the tasmota-sensors.bin and the portuguese language version of Tasmota
If you have a user_config_override.h
or platformio_override.ini
file with your custom settings you can put them in the script folder and they will be used on the next script run.
Script will update the repo folder with the latest one every run.
To check compiling logs use cat docker-tasmota.log
-
Clone this repo and cd to the dir where its cloned:
git clone https://github.com/tasmota/docker-tasmota cd docker-tasmota
-
Update the
user_config_override.h
and/orplatformio_override.ini
files with your custom build settings -
Run compile.sh with the desired build name, ex:
./compile.sh tasmota
If necessary the
compile.sh
script will install the container and Tasmota repo if you type 'yes' when prompted -
When compiling finishes you should have the compiled binary and gzipped version in
Tasmota/build_output/firmware
which can be flashed on your devices
Note: If you want to update the docker image installed previously by the compile.sh
script run:
docker pull blakadder/docker-tasmota
-
Clone this repo and cd to the dir where its cloned:
git clone https://github.com/tasmota/docker-tasmota cd docker-tasmota
-
Run this to build the docker container:
docker build -t docker-tasmota .
-
Move to a directory where you want to clone Tasmota repo:
git clone https://github.com/arendst/Tasmota.git
If you have a user_config_override.h
or platformio_override.ini
file with your custom settings, you will need to put them under Tasmota/tasmota
.
- From the same directory run to compile the desired build, full, sensors or ....
docker run -ti --rm -v $(pwd)/Tasmota:/tasmota -u $UID:$GID docker-tasmota -e tasmota-sensors
-e <buildname>
where can be any of the builds listed in platformio.ini. If you don't define a build then every build will get compiled.
- When compiling finishes you should have the compiled binary and gzipped version in
Tasmota/build_output/firmware
which can be flashed on your devices.
cd Tasmota
List branches with git branch -a
Switch to release branch with
git checkout release
Build it and run:
docker run -ti --rm \
-v $(pwd)/Tasmota:/tasmota \
-u $UID:$GID docker-tasmota