From 18e392bad9749e55f2fecba2b8a030e98674d3c1 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:05:16 +0200 Subject: [PATCH 01/12] add description for code review section --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index beef432..352e6e0 100644 --- a/README.md +++ b/README.md @@ -180,6 +180,8 @@ _Related: [IT Asset Management](#it-asset-management)_ **[`^ back to top ^`](#awesome-sysadmin)** +[Code review](https://en.wikipedia.org/wiki/Code_review) is a software quality assurance activity in which one or several people check a program mainly by viewing and reading parts of its source code. + **Please visit [awesome-selfhosted/Software Development - Project Management](https://github.com/awesome-selfhosted/awesome-selfhosted#software-development---project-management)** From 21514b1380a5d040f58e1954d904fdef0d05cf28 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:07:17 +0200 Subject: [PATCH 02/12] redirect identity management section to specialized subsections --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 352e6e0..03394ed 100644 --- a/README.md +++ b/README.md @@ -383,6 +383,8 @@ Open-source code editors. LDAP servers and other tools to manage accounts and identities. +**Please visit [Identity Management - LDAP](#identity-management---ldap), [Identity Management - Tools and web interfaces](#identity-management---tools-and-web-interfaces), [Identity Management - Single Sign-On SSO](#identity-management---single-sign-on-sso)** + ### Identity Management - LDAP From be7eafdea6bed01e69069d59d86a62894449d5a5 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:08:18 +0200 Subject: [PATCH 03/12] add description for identity management section --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 03394ed..d82927c 100644 --- a/README.md +++ b/README.md @@ -381,7 +381,7 @@ Open-source code editors. **[`^ back to top ^`](#awesome-sysadmin)** -LDAP servers and other tools to manage accounts and identities. +[Identity management](https://en.wikipedia.org/wiki/Identity_management) (IdM), also known as identity and access management (IAM or IdAM), is a framework of policies and technologies to ensure that the right users (that are part of the ecosystem connected to or within an enterprise) have the appropriate access to technology resources. **Please visit [Identity Management - LDAP](#identity-management---ldap), [Identity Management - Tools and web interfaces](#identity-management---tools-and-web-interfaces), [Identity Management - Single Sign-On SSO](#identity-management---single-sign-on-sso)** From f37ca3499896e737a291f2348164ff7f7a4423c9 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:09:12 +0200 Subject: [PATCH 04/12] add description for mail clients section --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index d82927c..bef3561 100644 --- a/README.md +++ b/README.md @@ -454,6 +454,8 @@ Log management tools: collect, parse, visualize... **[`^ back to top ^`](#awesome-sysadmin)** +An [email client](https://en.wikipedia.org/wiki/Email_client), email reader or, more formally, message user agent (MUA) or mail user agent is a computer program used to access and manage a user's email. + - [Claws Mail](http://www.claws-mail.org/) - Old school email client (and news reader), based on GTK+. ([Source Code](https://git.claws-mail.org/?p=claws.git;a=tree)) `GPL-3.0` `C` - [ImapSync](http://imapsync.lamiral.info/) - Simple IMAP migration tool for copying mailboxes to other servers. ([Source Code](https://github.com/imapsync/imapsync)) `NLPL` `Perl` - [Mutt](http://www.mutt.org/) - Small but very powerful text-based mail client. ([Source Code](https://gitlab.com/muttmua/mutt)) `GPL-2.0` `C` From 1a37e188f0a2782ae11759a3e227d1d87d4d1ce6 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:10:30 +0200 Subject: [PATCH 05/12] remove OMD (discontinued) - continued through CheckMK and OMD Labs-Edition (https://labs.consol.de/omd/) --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index bef3561..1748cc3 100644 --- a/README.md +++ b/README.md @@ -493,7 +493,6 @@ _Related: [Metrics & Metric Collection](#metrics--metric-collection)_ - [Netdata](https://www.netdata.cloud/) - Distributed, real-time, performance and health monitoring for systems and applications. Runs on Linux, FreeBSD, and MacOS. ([Source Code](https://github.com/netdata/netdata)) `GPL-3.0` `C` - [NetXMS](https://www.netxms.org/) - Open Source network and infrastructure monitoring and management. ([Source Code](https://github.com/netxms/netxms)) `LGPL-3.0/GPL-3.0` `Java/C++/C` - [Observium Community Edition](http://www.observium.org/) - Network monitoring and management platform that provides real-time insight into network health and performance. `QPL-1.0` `PHP` -- [OMD](http://omdistro.org/) - The Open Monitoring Distribution. - [Performance Co-Pilot](http://pcp.io) - Lightweight, distributed system performance and analysis framework. ([Source Code](https://github.com/performancecopilot/pcp)) `LGPL-2.1/GPL-2.0` `C` - [PHP Server Monitor](https://www.phpservermonitor.org/) - Open source tool to monitor your servers and websites. ([Source Code](https://github.com/phpservermon/phpservermon)) `GPL-3.0` `PHP` - [PhpSysInfo](https://phpsysinfo.github.io/phpsysinfo/) - A customizable PHP script that displays information about your system nicely. ([Source Code](https://github.com/phpsysinfo/phpsysinfo)) `GPL-2.0` `PHP` From 610c16bc92c0f31703f31495ae006f704071da6d Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:11:35 +0200 Subject: [PATCH 06/12] add description for status pages section - copied from https://github.com/awesome-selfhosted/awesome-selfhosted#status--uptime-pages --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 1748cc3..0e1ed4a 100644 --- a/README.md +++ b/README.md @@ -511,6 +511,8 @@ _Related: [Metrics & Metric Collection](#metrics--metric-collection)_ **[`^ back to top ^`](#awesome-sysadmin)** +[Uptime](https://en.wikipedia.org/wiki/Uptime) is a measure of system reliability, expressed as the percentage of time a machine, typically a computer, has been working and available. + **Please visit [awesome-selfhosted/Status / Uptime Pages](https://github.com/awesome-selfhosted/awesome-selfhosted#status--uptime-pages)** From 0ffd8c6e1d91f65318599ca4298b9f9a0024e72e Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:12:56 +0200 Subject: [PATCH 07/12] add description for packaging section --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 0e1ed4a..27378ac 100644 --- a/README.md +++ b/README.md @@ -564,6 +564,8 @@ Newsletter software. **[`^ back to top ^`](#awesome-sysadmin)** +A [package manager](https://en.wikipedia.org/wiki/Package_manager) or package-management system is a collection of software tools that automates the process of installing, upgrading, configuring, and removing computer programs for a computer in a consistent manner. + - [aptly](https://www.aptly.info/) - Swiss army knife for Debian repository management. ([Source Code](https://github.com/aptly-dev/aptly)) `MIT` `Go` - [fpm](https://fpm.readthedocs.io/en/latest/) - Versatile multi format package creator. ([Source Code](https://github.com/jordansissel/fpm)) `MIT` `Ruby` - [omnibus-ruby](https://github.com/chef/omnibus) - Easily create full-stack installers for your project across a variety of platforms. `Apache-2.0` `Ruby` From d6ef9701f32f1011ccdbf54320a6d08fcd5bce6d Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:15:21 +0200 Subject: [PATCH 08/12] add descriptino for queuing section --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 27378ac..0ea3796 100644 --- a/README.md +++ b/README.md @@ -585,6 +585,8 @@ Web-based project management and bug tracking systems. **[`^ back to top ^`](#awesome-sysadmin)** +[Message queues](https://en.wikipedia.org/wiki/Message_queue) and [message broker](https://en.wikipedia.org/wiki/Message_broker) software, typically used for inter-process communication (IPC), or for inter-thread communication within the same process. + - [ActiveMQ](https://activemq.apache.org/) - Java message broker. ([Source Code](https://github.com/apache/activemq)) `Apache-2.0` `Java` - [BeanstalkD](https://beanstalkd.github.io/) - A simple, fast work queue. ([Source Code](https://github.com/beanstalkd/beanstalkd)) `MIT` `C` - [Gearman](http://gearman.org/) - Fast multi-language queuing/job processing platform. ([Source Code](https://github.com/gearman/gearmand)) `BSD-3-Clause` `C++` From 98863d41e15d4943606b8f4ed15856725227d7e9 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:17:03 +0200 Subject: [PATCH 09/12] add description for router section - fix subversion and SoftEther entries syntax --- README.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 0ea3796..9da0aac 100644 --- a/README.md +++ b/README.md @@ -598,12 +598,12 @@ Web-based project management and bug tracking systems. ### Remote Desktop Clients +**[`^ back to top ^`](#awesome-sysadmin)** + [Remote Desktop](https://en.wikipedia.org/wiki/Remote_desktop_software) client software. _See also: [awesome-selfhosted/Remote Access](https://github.com/awesome-selfhosted/awesome-selfhosted#remote-access)_ -**[`^ back to top ^`](#awesome-sysadmin)** - - [Remmina](https://www.remmina.org/) - Feature-rich remote desktop application for linux and other unixes. ([Source Code](https://gitlab.com/Remmina/Remmina)) `GPL-2.0` `C` - [Tiger VNC](https://tigervnc.org/) - High-performance, multi-platform VNC client and server. ([Source Code](https://github.com/TigerVNC/tigervnc)) `GPL-2.0` `C++` - [X2go](https://wiki.x2go.org/doku.php) - X2Go is an open source remote desktop software for Linux that uses the NoMachine/NX technology protocol. ([Source Code](https://code.x2go.org/gitweb)) `GPL-2.0` `Perl` @@ -611,6 +611,10 @@ _See also: [awesome-selfhosted/Remote Access](https://github.com/awesome-selfhos ### Router +**[`^ back to top ^`](#awesome-sysadmin)** + +Software for management of [router](https://en.wikipedia.org/wiki/Router_(computing)) hardware. + - [DD-WRT](https://dd-wrt.com/) - A Linux-based firmware for wireless routers and access points, originally designed for the Linksys WRT54G series. ([Source Code](https://svn.dd-wrt.com/)) `GPL-2.0` `C` - [OpenWrt](https://openwrt.org/) - A Linux-based router featuring Mesh networking, IPS via snort and AQM among many other features. ([Source Code](https://git.openwrt.org/openwrt/openwrt.git)) `GPL-2.0` `C` - [OPNsense](https://opnsense.org/) - An open source FreeBSD-based firewall and router with traffic shaping, load balancing, and virtual private network capabilities. ([Source Code](https://github.com/opnsense)) `BSD-2-Clause` `C` `PHP` @@ -669,7 +673,7 @@ Software versioning and revision control. - [Fossil](https://www.fossil-scm.org/) - Distributed version control with built-in wiki and bug tracking. ([Source Code](https://www.fossil-scm.org/home/dir?ci=trunk)) `BSD-2-Clause` `C` - [Git](https://git-scm.com/) - Distributed revision control and source code management (SCM) with an emphasis on speed. ([Source Code](https://github.com/git/git)) `GPL-2.0` `C` - [Mercurial](https://www.mercurial-scm.org/) - Distributed source control management tool. ([Source Code](https://repo.mercurial-scm.org/hg/file/tip)) `GPL-2.0` `Python/C/Rust` -- [Subversion](https://subversion.apache.org/) - Client-server revision control system.([Source Code](https://svn.apache.org/repos/asf/subversion/trunk/)) `Apache-2.0` `C` +- [Subversion](https://subversion.apache.org/) - Client-server revision control system. ([Source Code](https://svn.apache.org/repos/asf/subversion/trunk/)) `Apache-2.0` `C` ### Virtualization @@ -704,7 +708,7 @@ VPN software. - [ocserv](http://www.infradead.org/ocserv/) - Cisco AnyConnect-compatible VPN server. ([Source Code](https://gitlab.com/ocserv/ocserv)) `GPL-2.0` `C` - [OpenVPN](https://community.openvpn.net) - Uses a custom security protocol that utilizes SSL/TLS for key exchange. ([Source Code](https://github.com/OpenVPN/openvpn)) `GPL-2.0` `C` - [PiVPN](https://www.pivpn.io/) - The simplest way to setup and manage a VPN, designed for Raspberry Pi. ([Source Code](https://github.com/pivpn/pivpn)) `MIT` `Shell` -- [SoftEther](https://www.softether.org/) - Multi-protocol software VPN with advanced features ([Source Code](https://github.com/SoftEtherVPN/SoftEtherVPN/)) `Apache-2.0` `C` +- [SoftEther](https://www.softether.org/) - Multi-protocol software VPN with advanced features. ([Source Code](https://github.com/SoftEtherVPN/SoftEtherVPN/)) `Apache-2.0` `C` - [sshuttle](https://github.com/sshuttle/sshuttle) - Poor man's VPN. `LGPL-2.1` `Python` - [strongSwan](https://www.strongswan.org/) - Complete IPsec implementation for Linux. ([Source Code](https://github.com/strongswan/strongswan)) `GPL-2.0` `C` - [tinc](http://www.tinc-vpn.org/) - Distributed p2p VPN. ([Source Code](https://www.tinc-vpn.org/git/tinc)) `GPL-2.0` `C` From 349d6d5689c78914852df89a0131104a2d2ddf9c Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:21:20 +0200 Subject: [PATCH 10/12] add missing descriptions for identity management sections --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 9da0aac..1d36273 100644 --- a/README.md +++ b/README.md @@ -390,6 +390,8 @@ Open-source code editors. **[`^ back to top ^`](#awesome-sysadmin)** +[Lightweight Directory Access Protocol (LDAP)](https://en.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol) is an open, vendor-neutral, industry standard application protocol for accessing and maintaining distributed directory information services over an Internet Protocol (IP) network. + - [389 Directory Server](https://www.port389.org/) - Enterprise-class Open Source LDAP server for Linux. ([Source Code](https://github.com/389ds/389-ds-base)) `GPL-3.0` `C` - [Apache Directory Server](https://directory.apache.org/apacheds/) - Extensible and embeddable directory server, certified LDAPv3 compatible, with Kerberos 5 and Change Password Protocol support, triggers, stored procedures, queues and views. ([Source Code](https://github.com/apache/directory-server)) `Apache-2.0` `Java` - [FreeIPA](https://www.freeipa.org/) - Integrated security information management solution combining Linux (Fedora), 389 Directory Server, Kerberos, NTP, DNS, and Dogtag Certificate System (web interface and command-line administration tools). ([Source Code](https://pagure.io/freeipa)) `GPL-3.0` `Python/C/JavaScript` @@ -402,6 +404,8 @@ Open-source code editors. **[`^ back to top ^`](#awesome-sysadmin)** +Miscellaneous utilities and web interfaces for identity management systems. + - [BounCA](https://bounca.org/) - A personal SSL Key / Certificate Authority web-based tool for creating self-signed certificates. ([Source Code](https://gitlab.com/bounca/bounca/)) `Apache-2.0` `Python` - [easy-rsa](https://github.com/OpenVPN/easy-rsa) - bash script to build and manage a PKI CA. `GPL-2.0` `Shell` - [Fusion Directory](https://www.fusiondirectory.org) - Improve the Management of the services and the company directory based on OpenLDAP. ([Source Code](https://github.com/fusiondirectory/fusiondirectory)) `GPL-2.0` `PHP` @@ -418,6 +422,8 @@ Open-source code editors. **[`^ back to top ^`](#awesome-sysadmin)** +[Single sign-on (SSO)](https://en.wikipedia.org/wiki/Single_sign-on) is an authentication scheme that allows a user to log in with a single ID to any of several related, yet independent, software systems. + - [Authelia](https://www.authelia.com/) - The Single Sign-On Multi-Factor portal for web apps. ([Source Code](https://github.com/authelia/authelia)) `Apache-2.0` `Go` - [Authentik](https://goauthentik.io/) - Flexible identity provider with support for different protocols. (OAuth 2.0, SAML, LDAP and Radius). ([Source Code](https://github.com/goauthentik/authentik)) `MIT` `Python` - [KeyCloak](https://www.keycloak.org) - Open Source Identity and Access Management. ([Source Code](https://github.com/keycloak/keycloak)) `Apache-2.0` `Java` From e077639e826e187174b82932af4995860ba7a329 Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:22:43 +0200 Subject: [PATCH 11/12] tools/hecat: only load licenses from licenses.yml - licenses-nonfree.yml is not a file or directory --- .hecat/awesome-lint.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.hecat/awesome-lint.yml b/.hecat/awesome-lint.yml index bc2adf5..d56bf82 100644 --- a/.hecat/awesome-lint.yml +++ b/.hecat/awesome-lint.yml @@ -5,4 +5,3 @@ steps: source_directory: ./ licenses_files: - licenses.yml - - licenses-nonfree.yml From 806d039b7f255bacd4e78c5a8c4d4e3faa50e53b Mon Sep 17 00:00:00 2001 From: nodiscc Date: Mon, 4 Sep 2023 14:38:44 +0200 Subject: [PATCH 12/12] tools/makefile: add clean target (clean files generated by automated tasks) --- Makefile | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Makefile b/Makefile index b87fa49..e4a08f1 100644 --- a/Makefile +++ b/Makefile @@ -24,6 +24,10 @@ url_check: install source .venv/bin/activate && \ hecat --config .hecat/url-check.yml +.PHONY: clean # clean files generated by automated tasks +clean: + rm -rf .venv/ licenses.yml platforms/ software/ tags/ + .PHONY: help # generate list of targets with descriptions help: @grep '^.PHONY: .* #' Makefile | sed 's/\.PHONY: \(.*\) # \(.*\)/\1 \2/' | expand -t20