This role will setup a simple webserver homepage/dashboard:
- Links to services installed on the host (if managed by xsrv roles)
- Custom links
See meta/main.yml
- hosts: my.CHANGEME.org
roles:
- nodiscc.xsrv.common # (optional) base server setup, hardening
- nodiscc.xsrv.monitoring # (optional) system/server monitoring and health checks
- nodiscc.xsrv.apache # (required in the standard configuration) web server and SSL/TLS certificates
- nodiscc.xsrv.shaarli # (example) any supported role, a link to this application on the homepage will be added
- nodiscc.xsrv.nextcloud # (example) any supported role, a link to this application on the homepage will be added
- nodiscc.xsrv.homepage # the homepage role must be deployed *after* application roles
# required variables:
# host_vars/my.CHANGEME.org/my.CHANGEME.org.yml
homepage_fqdn: "www.CHANGEME.org"See defaults/main.yml for all configuration variables
Access the homepage in a web browser at the URL/domain name defined by {{ homepage_fqdn }}.
You can add custom links using the homepage_custom_links variable/list. For example:
$ xsrv edit-host default my.example.org
homepage_custom_links:
- url: https://dev.example.org
title: dev.example.org
description: "Development server 1"
- url: https://cloud2.example.org
title: Cloud2
description: "Public file sharing server"
icon: nextcloud
- url: https://steamcommunity.com/chat/
title: Steam Chat
description: "Steam community web chat"
icon: steam
- url: https://mail.google.com/mail/u/0/#inbox
title: Gmail
icon: gmail
- url: https://github.com/issues/assigned
title: Github
icon: githubYou can use any of the icons provided by this role as value for the icon: key. If you wish to upload custom icons, you can create a custom role as a supplement to this one. See the nodiscc.toolbox.homepage_extra_icons role for an example.
Icons must have a .png extension, and should have dimensions of 16x16px for a consistent appearance.
homepage - setup simple webserver homepage