This is FastyBird MiniServer Edition repository for starting new projects.

MiniServer is standalone application based on FastyBird IoT software. The highest quality of code and strong testing culture, make it best solution for build smart controller application.

FastyBird IoT MiniServer is an Apache2 licensed distributed application, developed on top of the Nette framework and Symfony framework.

• Devices & connectors management
• User & access control management
• {JSON:API} strong api for application management
• Responsive user interface
• Third party devices integration like Shelly, Tuya and other
• Full HomeKit with HAP protocol integration

FastyBird MiniServer is tested against PHP 8.1, Redis 6.2 in-memory data store, MySQL relational database management system, ReactPHP http 0.8 event-driven, streaming plaintext HTTP server and Nette framework 3.0 PHP framework for real programmers.

NOTE: If you don't want to install it manually, try docker image

The best way to install fastybird/miniserver is using Composer. If you don't have Composer yet, download it following the instructions. Then use command:

composer create-project --no-dev fastybird/miniserver path/to/install

cd path/to/install

Everything required will be then installed in the provided folder path/to/install

You have two options how to run this app

All what you need is just run one console command:

vendor/bin/fb-console fb:web-server:start

This command will start build in web server which is listening for incoming http api request messages from clients.

You have to configure you web server running on Apache or Nginx to server content from public folder.

In this folder is main entry point for accessing application api.

Docker image: fastybird/miniserver

docker run -d -it --name devices fastybird/miniserver:latest

docker build --tag=miniserver .

docker run -d -it --name miniserver miniserver

This application is using database, and need some initial data to be inserted into it. This could be done via shell command:

vendor/bin/fb-console fb:initialize

This console command is interactive and will ask for all required information.

After this steps, application could be started with server command

Use the issue tracker for bugs or mail or Tweet us for any idea that can improve the project.

Thank you for testing, reporting and contributing.

For release info check release page

Adam Kadlec

Homepage https://www.fastybird.com and repository https://github.com/fastybird/miniserver.