mirror of
https://github.com/roles-ansible/ansible_role_rustdesk.git
synced 2024-08-16 10:19:48 +02:00
Improve docs
This commit is contained in:
parent
11a17d4582
commit
c2671276d7
2 changed files with 33 additions and 31 deletions
63
README.md
63
README.md
|
@ -1,40 +1,41 @@
|
||||||
[![Ansible Galaxy](https://ansible.l3d.space/svg/l3d.rustdesk.svg)](https://galaxy.ansible.com/ui/standalone/roles/l3d/rustdesk/)
|
[![Ansible Galaxy](https://ansible.l3d.space/svg/roles-ansible.rustdesk.svg)](https://galaxy.ansible.com/ui/standalone/roles/roles-ansible/rustdesk/)
|
||||||
[![MIT](https://ansible.l3d.space/svg/l3d.rustdesk_license.svg)](LICENSE)
|
[![MIT](https://ansible.l3d.space/svg/roles-ansible.rustdesk_license.svg)](LICENSE)
|
||||||
[![Maintainance](https://ansible.l3d.space/svg/l3d.rustdesk_maintainance.svg)](https://ansible.l3d.space/#l3d.rustdesk)
|
[![Maintainance](https://ansible.l3d.space/svg/roles-ansible.rustdesk_maintainance.svg)](https://ansible.l3d.space/#roles-ansible.rustdesk)
|
||||||
|
|
||||||
ansible_role_template
|
ansible role rustdesk
|
||||||
=======================
|
=======================
|
||||||
Ansible role to install a selfhosted rustdesk-server.
|
Ansible role to install a selfhosted rustdesk-server.
|
||||||
|
|
||||||
DOCS: https://rustdesk.com/docs/en/self-host/
|
You can find more information about hosting rustdesk for yourself at [rustdesk.com/docs](https://rustdesk.com/docs/en/self-host/).
|
||||||
Core Ports:
|
|
||||||
TCP 21115-21117
|
|
||||||
UDP 21116
|
|
||||||
|
|
||||||
## Variables:
|
Rustdesk Requirements
|
||||||
|
=======================
|
||||||
|
To kommunikate with rustdesk, you need to open these Ports on the rustdesk server:
|
||||||
|
+ TCP Ports: ``21115-21117``
|
||||||
|
+ UDP Ports: ``21116``
|
||||||
|
|
||||||
```yml
|
*Some of the Ports can be changed in the config*
|
||||||
---
|
|
||||||
rustdesk__version: 'latest'
|
|
||||||
|
|
||||||
rustdesk__user: 'rustdesk'
|
## Ansible Role Variables
|
||||||
rustdesk__group: "{{ rustdesk__user }}"
|
|
||||||
rustdesk__home: '/var/lib/rustdesk'
|
|
||||||
rustdesk__user_home: "{{ rustdesk__home }}"
|
|
||||||
rustdesk__ignore_version_mismatch: false
|
|
||||||
rustdesk__require_key: true
|
|
||||||
rustdesk__relay_server_domain: "{{ ansible_fqdn }}"
|
|
||||||
rustdesk__relay_server_port: '21117'
|
|
||||||
rustdesk__signal_server_port: '21116'
|
|
||||||
|
|
||||||
rustdesk__hbbr_executable_path: '/usr/local/bin/hbbr'
|
| Variable | Value | Description |
|
||||||
rustdesk__hbbs_executable_path: '/usr/local/bin/hbbs'
|
| --- | --- | --- |
|
||||||
rustdesk__rustdesk_utils_executable_path: '/usr/local/bin/rustdesk-utils'
|
| ``rustdesk__version`` | ``latest`` | Specify the wanted rustdesk release or install latest |
|
||||||
|
| ``rustdesk__user`` | ``rustdesk`` | Unix User Name |
|
||||||
|
| ``rustdesk__group`` | ``{{ rustdesk__user }}`` | Unix Group Name |
|
||||||
|
| ``rustdesk__home`` | ``/var/lib/rustdesk`` | Application Working Enviroment |
|
||||||
|
| ``rustdesk__user_home`` | ``{{ rustdesk__home }}`` | Unix Home |
|
||||||
|
| ``rustdesk__ignore_version_mismatch`` | ``false`` | Ignore the fact that hbbs and hbbr versions mismatch. *(not recomended)* |
|
||||||
|
| ``rustdesk__require_key`` | ``true`` | prohibit users without the key from establishing non-encrypted connections |
|
||||||
|
| ``rustdesk__relay_server_domain`` | ``{{ ansible_fqdn }}`` | What is the Domain/IP from your rustdesk relay server? |
|
||||||
|
| ``rustdesk__relay_server_port`` | ``21117`` | Rustdesk Relay Port |
|
||||||
|
| ``rustdesk__signal_server_port`` | ``21116`` | Rustdesk Signal Server Port |
|
||||||
|
| ``rustdesk__hbbr_executable_path`` | ``/usr/local/bin/hbbr`` | Rustdesk relay server executable |
|
||||||
|
| ``rustdesk__hbbs_executable_path`` | ``/usr/local/bin/hbbs`` | Rustdesk signal server executable |
|
||||||
|
| ``rustdesk__rustdesk_utils_executable_path`` | ``/usr/local/bin/rustdesk-utils`` | Rustdesk utils path executable |
|
||||||
|
| ``submodules_versioncheck`` | ``false`` | Run simple Versionscheck *(recomended)* |
|
||||||
|
|
||||||
# should we do a version check? (recomended)
|
License
|
||||||
submodules_versioncheck: false
|
=========
|
||||||
```
|
+ This Ansible role us under [MIT License](LICENSE).
|
||||||
|
+ Please feel free to open a issue or pull-request.
|
||||||
# TODOs
|
|
||||||
+ Create more fancy DOCs
|
|
||||||
+ Create logos on ansible.l3d.space
|
|
||||||
|
|
|
@ -2,6 +2,7 @@
|
||||||
galaxy_info:
|
galaxy_info:
|
||||||
role_name: rustdesk
|
role_name: rustdesk
|
||||||
author: l3d
|
author: l3d
|
||||||
|
namespace: 'roles-ansible'
|
||||||
description: Ansible role to install and configure rustdesk-server.
|
description: Ansible role to install and configure rustdesk-server.
|
||||||
license: "MIT"
|
license: "MIT"
|
||||||
min_ansible_version: "2.16"
|
min_ansible_version: "2.16"
|
||||||
|
|
Loading…
Reference in a new issue