https://github.com/pgporada/ansible-role-screenconnect

Installs and configures ConnectWise ScreenConnect.
https://github.com/pgporada/ansible-role-screenconnect

ansible-role connectwise remote-access remote-admin-tool remote-control screenconnect

Last synced: 4 months ago
JSON representation

Installs and configures ConnectWise ScreenConnect.

• Host: GitHub
• URL: https://github.com/pgporada/ansible-role-screenconnect
• Owner: pgporada
• Created: 2019-02-24T01:54:08.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-02-24T04:37:14.000Z (over 7 years ago)
• Last Synced: 2025-09-05T13:56:47.147Z (10 months ago)
• Topics: ansible-role, connectwise, remote-access, remote-admin-tool, remote-control, screenconnect
• Language: Ruby
• Size: 201 KB
• Stars: 6
• Watchers: 1
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![Donate to my project with Paypal](https://img.shields.io/badge/paypal-beerBucket-yellow.svg)](https://paypal.me/pgporada)

[![pgporada.screenconnect](https://img.shields.io/badge/role-pgporada.screenconnect-blue.svg)](https://galaxy.ansible.com/pgporada/screenconnect)

[![License](https://img.shields.io/badge/license-GPLv2-brightgreen.svg)](LICENSE)

# Overview: ansible-role-screenconnect

This role will download and install the latest Linux version of [ConnectWise ScreenConnect](https://www.connectwise.com/software/control/download).

If this helps you out, consider throwing a few dollars in the beer bucket up top.

![Working install of ScreenConnect behind an Apache reverse proxy](screenconnect.png)

- - - -

# Variables

None

- - - -

# How to use this role

1. Via the included playbook as `ansible-playbook local_playbook.yml -K`

1. As part of another playbook `pgporada.screenconnect`

1. You will want to configure this behind a reverse proxy such as Apache, Nginx, or Caddy. An example reverse proxy file is included in [examples/](examples/reverseproxy/) and a working example can be found in the [tests.](test/integration/default/default.yml)

- - - -

# How to hack away at this role

Before submitting a PR, please create a test and run it through test-kitchen. You will need to have at least Ruby 2.x, probably through rbenv, and Bundler.

    bundle update

    bundle install

    bundle exec kitchen create

    bundle exec kitchen converge

    bundle exec kitchen verify

Open your web browser and navigate to http://192.168.33.15 to complete the ScreenConnect setup

    # Clean up after ourselves

    bundle exec kitchen destroy

- - - -

# Theme Music

[Derrick Morgan - The Conqueror](https://www.youtube.com/watch?v=OVmuRgn0LRI)

- - - -

# Copyright and Author Info

(C) [Phil Porada](https://philporada.com) 2019 - philporada@gmail.com