https://github.com/haxall/haxall
Haxall IoT framework
https://github.com/haxall/haxall
fantom haystack iot iot-framework iot-gateway project-haystack
Last synced: 19 days ago
JSON representation
Haxall IoT framework
- Host: GitHub
- URL: https://github.com/haxall/haxall
- Owner: haxall
- License: afl-3.0
- Created: 2021-03-30T17:37:52.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-03-02T21:18:20.000Z (26 days ago)
- Last Synced: 2026-03-03T00:35:36.585Z (26 days ago)
- Topics: fantom, haystack, iot, iot-framework, iot-gateway, project-haystack
- Language: Fantom
- Homepage: https://haxall.io/
- Size: 8.08 MB
- Stars: 66
- Watchers: 14
- Forks: 38
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Haxall Overview
Haxall is an open source software framework for the Internet of Things.
It includes an extensive toolkit for working with [Project Haystack](https://project-haystack.org/)
data. Use it right out of the box as a flexible IoT data gateway which runs at
the edge. Haxall is written in [Fantom](https://fantom.org/) with
runtime support for both the Java VM and JavaScript environments.
See [https://haxall.io](https://haxall.io) for more more information.
# Getting Started
All the documentation is hosted on [haxall.io](https://haxall.io):
- [Setup](https://haxall.io/doc/docHaxall/Setup): install and get Haxall running
- [Build](https://haxall.io/doc/docHaxall/Build): instructions to build from source
- [Learn](https://haxall.io/doc/appendix/learn): quick links to learn more
# License
Haxall is released under the [Academic Free License 3.0](https://opensource.org/licenses/AFL-3.0).
# Running Docker Containers
[Docker Desktop](https://www.docker.com/products/docker-desktop/) must be installed and running in the background to create Docker images and containers and to run Docker containers. Docker images must be created using Docker Compose and the below instructions.
Please note:
- Following the below instructions will result in a local bind-mount `dbs` folder being created on your filesystem for persisting data if it does not already exist
- A database is initialized only if a directory named according to the `HAXALL_DB_NAME` environment variable does not exist in the `dbs` folder
- When a non-default password is not specified and a new database is created, a default password is generated and displayed in the container's standard output
- Once the container is running, go to http://localhost:8080 to use haxall with the configured username and password. If the default port 8080 was not configured, then go to http://localhost: instead.
## 1. Build the image yourself with Docker Compose
- Verify Docker Desktop is installed and running.
- Download the latest release of haxall (any releases before Oct 24, 2025 will not have this functionality), or clone the repository.
- In the root folder of haxall create a file called `.env` that defines environment variables for the Docker container to be created. An example template for this file is shown below.
```ini
HAXALL_PORT= # defaults to 8080
HAXALL_DB_NAME= # defaults to var
HAXALL_SU_USERNAME= # defaults to su
HAXALL_SU_PASSWORD= # defaults to automatically generated password
```
Note: Default values are applied to the environment variables shown above if they are not user defined.
- Run this command on a terminal in the root folder of haxall on your local system:
```bash
docker compose up
```
This command will perform the following:
- Build an image for haxall
- Use the newly created image to create and run a container
- Create a local bind-mount in the `dbs` folder in the root folder of haxall