Giter Club home page Giter Club logo

iobroker.admin's Introduction

Logo

ioBroker.admin

NPM version Downloads Stable installed

NPM

User interface for configuration and administration of ioBroker.

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Using common.localLink

  • %ip% - ioBroker ip address (address of the admin)
  • %secure% or %protocol% - read from native.secure the value and use http or https
  • %web_protocol% - looking for the first instance of web (e.g. web.0) and get native.secure from system.adapter.web.0
  • %instance% - instance of the adapter
  • %someField% - get someField from native of this adapter instance
  • %web.0_bind% - get native.bind from system.adapter.web.0
  • %native_someField% - get someField from native of this adapter instance

Scheduled restart

Some adapters re not stable or connection disappear after one or two days. To fix this there is a scheduled restart setting. To activate scheduled restart just define CRON condition when to restart adapter.

It is suggested to restart in the night, when no one use the adapter, e.g. "0 3 * * *" - at 3:00 every day.

Let's Encrypt Certificates

Let’s Encrypt is a free, automated, and open certificate authority brought to you by the non-profit Internet Security Research Group (ISRG).

You can read about Let’s Encrypt here.

Some installations use Dynamic DNS and Co to get the domain name and to reach under this domain name own web sites. ioBroker supports automatic request and renew of certificates from Let’s Encrypt Organisation.

There is an option to activate free certificates from Let’s Encrypt almost in every adapter, that can start some web server and supports HTTPS.

If you just enable the using of certificates and will not activate an automatic update the instance will try to use stored certificates.

If the automatic update is activated the instance will try to request certificates from Let’s Encrypt and will automatically update it.

The certificates will be first requested when the given domain address will be accessed. E.g. you have "sub.domain.com" as address, when you try to access https://sub.domain.com the certificates will be first requested and it can last a little before first answer will come.

The issuing of certificates is rather complex procedure, but if you will follow the explanation you will easy get free certificates.

Description:

  1. The new account will be created with given email address (you must set it up in system settings)
  2. Some random key will be created as password for the account.
  3. After the account is created the system starts on port 80 the small website to confirm the domain.
  4. Let's encrypt use always port 80 to check the domain.
  5. If port 80 is occupied by other service see point 4.
  6. After the small web server is up the request to get certificates for given domains (system settings) will be sent to the Let's encrypt server.
  7. Let's encrypt server sends back some challenge phrase as answer on the request and after a while tries to read this challenge phrase on "http://yourdomain:80/.well-known/acme-challenge/"
  8. If challenge phrase from our side comes back the Let's encrypt server send us the certificates. They will be stored in the given directory (system settings).

Sounds complex, but everything what you must do is to activate checkboxes and specify your email and domain in system settings.

The received certificates are valid ca. 90 days. After the certificates are received the special task will be started to automatically renew the certificates.

The topic is rather complex and 1000 things can go wrong. If you cannot get certificates please use cloud service to reach your installation from internet.

Let's encrypt works only from node.js version>=4.5

Simple instance's settings page

The user has the possibility to limit the access to the instance configuration dialog. For that the option "Allow access only to specific instances" must be activated. It could be found on the "Access to instances" tab. Additionally the allowed instances should be selected in the appeared configuration table.

If this option is disabled, the simple configuration page could be accessed under http://IP:8081/configs.html

Todo

  • move html tooltips to materialize tooltips
  • tiles for hosts (additionally to table - low prior)
  • tiles for instances (additionally to table - low prior)

Used icons

This project uses some icons from Flaticon:

Changelog

5.0.6 (2021-04-20)

  • (bluefox) Admin5: Fixed many bugs

5.0.5 (2021-04-20)

  • (bluefox) Admin5: Fixed many bugs

5.0.4 (2021-04-18)

  • (bluefox) Admin5: Fixed many bugs

5.0.3 (2021-04-17)

  • (bluefox) Admin5: Many new features implemented

5.0.2 (2020-12-26)

  • (bluefox) Merged the changes from admin4

License

The MIT License (MIT)

Copyright (c) 2014-2021 bluefox [email protected]

iobroker.admin's People

Contributors

alcalzone avatar apollon77 avatar backgroundworkers avatar bondrogeen avatar buzzy1337 avatar deepcoresystem avatar dilesoft avatar dobis19 avatar dutchmannl avatar foxriver76 avatar fredf63 avatar genagl avatar germanbluefox avatar hobbyquaker avatar homoran avatar instalator avatar ldittmar81 avatar maxblome avatar metromdouble avatar paul53 avatar schumyhao avatar smiling-jack avatar snyk-bot avatar soef avatar stabilostick avatar steiger04 avatar tmikulski avatar ykuendig avatar zalash333 avatar zefau avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.