eb9d9c7b84
- remove sandbox references (will be removed soon) - fix static user management description - remove device simulator - shall be used sdk Signed-off-by: Avgustin Marinov <Avgustin.Marinov@bosch.com>
2.5 KiB
Executable File
title, weight
| title | weight |
|---|---|
| Getting Started | 20 |
From Docker Image
Overview
HawkBit Update Server default user has admin/admin as default credentials. See below how the user can be changed.
It supports two configurations:
- monolith - hawkbit-update-server
- micro-service - hawkbit-mgmt-server, hawkbit-ddi-server, hawkbit-dmf-server.
A: Run hawkBit Update Server (Monolith) as Docker Container
Start the hawkBit Update Server as a single container
$ docker run -p 8080:8080 hawkbit/hawkbit-update-server:latest
B: Run hawkBit Update Server (Monolith) with services as Docker Compose
Start the hawkBit Update Server together with an MySQL and RabbitMQ instance as containers
$ git clone https://github.com/eclipse-hawkbit/hawkbit.git
$ cd hawkbit/hawkbit-runtime/docker
$ docker-compose -f docker-compose-monolith-mysql.yml up -d
C: Run hawkBit Update Server (Micro-Service) with services as Docker Compose
Start the hawkBit Update Server together with an MySQL and RabbitMQ instance as containers
$ git clone https://github.com/eclipse-hawkbit/hawkbit.git
$ cd hawkbit/hawkbit-runtime/docker
$ docker-compose -f docker-compose-micro-service-mysql.yml up -d
From Sources
1: Clone and build hawkBit
$ git clone https://github.com/eclipse-hawkbit/hawkbit.git
$ cd hawkbit
$ mvn clean install -DskipTests
2: Start hawkBit update server (Monolith)
$ java -jar ./hawkbit-monolith/hawkbit-update-server/target/hawkbit-update-server-0-SNAPSHOT.jar
3: Change credentials
As stated before the default user is admin/admin. It could be overridden by changing the TenantAwareUserProperties configuration using Spring ways. For instance, using a properties file like:
# should remove the admin/admin user
hawkbit.security.user.admin.tenant=#{null}
hawkbit.security.user.admin.password=#{null}
hawkbit.security.user.admin.roles=#{null}
# should add a hawkbit/isAwesome! user
hawkbit.security.user.hawkbit.tenant=DEFAULT
hawkbit.security.user.hawkbit.password={noop}isAwesome!
hawkbit.security.user.hawkbit.roles=TENANT_ADMIN
which should remove the default admin/admin user and add a hawkbit user hawkbit with password isAwesome! and a role TENANT_ADMIN.
You could create multiple users with specified roles.