Skip to content

Commit

Permalink
Merge branch 'main' into Tearran-patch-2
Browse files Browse the repository at this point in the history
  • Loading branch information
Tearran authored Dec 5, 2024
2 parents 9bb6126 + d0cd842 commit 89770f6
Show file tree
Hide file tree
Showing 24 changed files with 820 additions and 22 deletions.
142 changes: 124 additions & 18 deletions DOCUMENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,12 @@ sudo armbian-config
- ### Manage device tree overlays


- ### ZFS filesystem - enable support


- ### ZFS filesystem - remove support




- ## **Network**
Expand Down Expand Up @@ -137,6 +143,18 @@ sudo armbian-config
- ### Remove Readarr
- ### Install Prowlarr
- ### Remove Prowlarr
- ### Jellyseerr install
- ### Jellyseerr remove
- ### Jellyseerr purge data folder


- ### Database
- ### Mariadb install
- ### Mariadb remove
- ### Mariadb purge
- ### phpMyAdmin install
- ### phpMyAdmin remove
- ### phpMyAdmin purge


- ### DNS blockers
Expand Down Expand Up @@ -167,18 +185,36 @@ sudo armbian-config
- ### Purge all Docker images, containers, and volumes
- ### Install Portainer
- ### Remove Portainer
- ### Watchtower install
- ### Watchtower remove


- ### Media Servers and Editors
- ### Install Plex Media server
- ### Remove Plex Media server
- ### Install Emby server
- ### Remove Emby server
- ### Stirling-PDF Install
- ### Stirling-PDF Remove
- ### Stirling-PDF Purge data folder
- ### Syncthing Install
- ### Syncthing Remove
- ### Syncthing Purge data folder
- ### Nextcloud Install
- ### Nextcloud Remove
- ### Nextcloud Purge data folder
- ### Owncloud Install
- ### Owncloud Remove
- ### Owncloud Purge data folder


- ### Monitoring
- ### Install Uptime Kuma
- ### Uninstall Uptime Kuma
- ### Uptime Kuma install
- ### Uptime Kuma remove
- ### Uptime Kuma purge data folder
- ### Netdata Install
- ### Netdata remove
- ### Netdata purge data folder


- ### Remote Management tools
Expand Down Expand Up @@ -255,6 +291,8 @@ Outputs:
--cmd SY014 - Adjust welcome screen (motd)
--cmd SY015 - Install alternative kernels
--cmd SY017 - Manage device tree overlays
--cmd SY018 - ZFS filesystem - enable support
--cmd SY019 - ZFS filesystem - remove support
Network - Fixed and wireless network settings (eth0)
NE001 - Configure network interfaces
Expand All @@ -281,27 +319,37 @@ Outputs:
--cmd NET008 - Remove hostname broadcast via mDNS (avahi-daemon)
Downloaders - Download tools
--cmd DOW001 - Install qBittorrent
--cmd DOW002 - Remove qBittorrent (http://10.1.0.7:8090 6881)
--cmd DOW002 - Remove qBittorrent (http://10.1.0.10:8090 6881)
--cmd DOW003 - Install Deluge
--cmd DOW004 - Remove Deluge (http://10.1.0.7:8112 6181 58846)
--cmd DOW004 - Remove Deluge (http://10.1.0.10:8112 6181 58846)
--cmd DOW005 - Install Transmission
--cmd DOW006 - Remove Transmission (http://10.1.0.7:9091)
--cmd DOW006 - Remove Transmission (http://10.1.0.10:9091)
--cmd DOW011 - Install SABnzbd
--cmd DOW012 - Remove SABnzbd (http://10.1.0.7:8080)
--cmd DOW012 - Remove SABnzbd (http://10.1.0.10:8080)
--cmd DOW013 - Install Medusa
--cmd DOW014 - Remove Medusa (http://10.1.0.7:8081)
--cmd DOW014 - Remove Medusa (http://10.1.0.10:8081)
--cmd DOW015 - Install Sonarr
--cmd DOW016 - Remove Sonarr (http://10.1.0.7:8989)
--cmd DOW016 - Remove Sonarr (http://10.1.0.10:8989)
--cmd DOW017 - Install Radarr
--cmd DOW018 - Remove Radarr (http://10.1.0.7:7878)
--cmd DOW018 - Remove Radarr (http://10.1.0.10:7878)
--cmd DOW019 - Install Bazarr
--cmd DOW020 - Remove Bazarr (http://10.1.0.7:6767)
--cmd DOW020 - Remove Bazarr (http://10.1.0.10:6767)
--cmd DOW021 - Install Lidarr
--cmd DOW022 - Remove Lidarr (http://10.1.0.7:8686)
--cmd DOW022 - Remove Lidarr (http://10.1.0.10:8686)
--cmd DOW023 - Install Readarr
--cmd DOW024 - Remove Readarr (http://10.1.0.7:8787)
--cmd DOW024 - Remove Readarr (http://10.1.0.10:8787)
--cmd DOW025 - Install Prowlarr
--cmd DOW026 - Remove Prowlarr (http://10.1.0.7:9696)
--cmd DOW026 - Remove Prowlarr (http://10.1.0.10:9696)
--cmd DOW040 - Jellyseerr install
--cmd DOW041 - Jellyseerr remove (http://10.1.0.10:5055)
--cmd DOW042 - Jellyseerr purge data folder
Database - Database
--cmd DAT001 - Mariadb install
--cmd DAT002 - Mariadb remove (Server: 10.1.0.10)
--cmd DAT003 - Mariadb purge
--cmd DAT005 - phpMyAdmin install
--cmd DAT006 - phpMyAdmin remove (http://10.1.0.10:8071)
--cmd DAT007 - phpMyAdmin purge
DNS - DNS blockers
--cmd DNS001 - Install Pi-hole DNS ad blocker
--cmd DNS002 - Set Pi-hole web admin password
Expand All @@ -313,23 +361,41 @@ Outputs:
--cmd HA001 - Install openHAB
--cmd HA002 - Remove openHAB
--cmd HA003 - Install Home Assistant
--cmd HA004 - Remove Home Assistant (http://10.1.0.7:8123)
--cmd HA004 - Remove Home Assistant (http://10.1.0.10:8123)
--cmd Benchy - System benchmaking and diagnostics
Containers - Containerlization and Virtual Machines
--cmd CON001 - Install Docker Minimal
--cmd CON002 - Install Docker Engine
--cmd CON003 - Remove Docker
--cmd CON004 - Purge all Docker images, containers, and volumes
--cmd CON005 - Install Portainer
--cmd CON006 - Remove Portainer (http://10.1.0.7:9000)
--cmd CON006 - Remove Portainer (http://10.1.0.10:9000)
--cmd CON007 - Watchtower install
--cmd CON008 - Watchtower remove
Media - Media Servers and Editors
--cmd MED001 - Install Plex Media server
--cmd MED002 - Remove Plex Media server
--cmd MED003 - Install Emby server
--cmd MED004 - Remove Emby server
--cmd MED010 - Stirling-PDF Install
--cmd MED011 - Stirling-PDF Remove
--cmd MED012 - Stirling-PDF Purge data folder
--cmd MED015 - Syncthing Install
--cmd MED016 - Syncthing Remove (http://10.1.0.10:8884)
--cmd MED017 - Syncthing Purge data folder
--cmd MED020 - Nextcloud Install
--cmd MED021 - Nextcloud Remove (https://10.1.0.10:443)
--cmd MED022 - Nextcloud Purge data folder
--cmd MED025 - Owncloud Install
--cmd MED026 - Owncloud Remove (http://10.1.0.10:7787)
--cmd MED027 - Owncloud Purge data folder
Monitoring - Monitoring
--cmd MON001 - Install Uptime Kuma
--cmd MON002 - Uninstall Uptime Kuma
--cmd MON001 - Uptime Kuma install
--cmd MON002 - Uptime Kuma remove
--cmd MON003 - Uptime Kuma purge data folder
--cmd MON005 - Netdata Install
--cmd MON006 - Netdata remove
--cmd MON007 - Netdata purge data folder
Management - Remote Management tools
--cmd MAN001 - Install Cockpit web-based management tool
--cmd MAN002 - Purge Cockpit web-based management tool
Expand Down Expand Up @@ -533,6 +599,26 @@ Jobs:
manage_dtoverlays
~~~
### SY018
ZFS filesystem - enable support
Jobs:
~~~
module_zfs install
~~~
### SY019
ZFS filesystem - remove support
Jobs:
~~~
module_zfs remove
~~~
### NE001
Configure network interfaces
Expand Down Expand Up @@ -606,6 +692,16 @@ Jobs:
No commands available
~~~
### Database
Database
Jobs:
~~~
No commands available
~~~
### DNS
DNS blockers
Expand Down Expand Up @@ -717,14 +813,18 @@ These helper functions facilitate various operations related to job management,
| Hos container install and configure | help install uninstall | @igorpecovnik
| Set Armbian root filesystem to read only | manage_overlayfs enable/disable | @igorpecovnik
| Display a menu from pipe | show_menu <<< armbianmonitor -h ; | @Tearran
| Install watchtower container | install remove status help | @armbian
| Build the main menu from a object | generate_top_menu 'json_data' | @Tearran
| Install bazarr container | install remove status help | @igorpecovnik
| Install headers container | install remove status help | @armbian
| Migrated procedures from Armbian config. | is_package_manager_running | @armbian
| Migrated procedures from Armbian config. | check_desktop | @armbian
| Install phpmyadmin container | install remove purge status help |
| Install stirling container | install remove purge status help | @Frooodle
| Install sonarr container | install remove status help | @armbian
| Generate Document files. | generate_readme | @Tearran
| Storing netplan config to tmp | store_netplan_config | @igorpecovnik
| Install jellyseerr container | install remove purge status help | @armbian
| Needed by generate_menu | execute_command 'id' | @Tearran
| Display a Yes/No dialog box and process continue/exit | get_user_continue 'Do you wish to continue?' process_input | @Tearran
| Migrated procedures from Armbian config. | connect_bt_interface | @armbian
Expand All @@ -737,6 +837,7 @@ These helper functions facilitate various operations related to job management,
| Install/uninstall/check status of portainer container | help install uninstall status | @armbian
| Migrated procedures from Armbian config. | check_if_installed nano | @armbian
| Generate 'Armbian CPU logo' SVG for document file. | generate_svg | @Tearran
| Install zfs filesystem support | install remove status kernel_max zfs_version help | @armbian
| Update submenu descriptions based on conditions | update_submenu_data | @Tearran
| sanitize input cli | sanitize_input | @Tearran
| Install lidarr container | install remove status help | @armbian
Expand All @@ -753,17 +854,21 @@ These helper functions facilitate various operations related to job management,
| Install qbittorrent container | install remove status help | @armbian
| Generate JSON-like object file. | generate_json | @Tearran
| Install transmission container | install remove status help | @armbian
| Install nextcloud container | install remove purge status help |
| Install wrapper | apt_install_wrapper apt-get -y purge armbian-zsh | @igorpecovnik
| Uses Avalible (Whiptail, DIALOG, READ) for the menu interface | <function_name> | Tearran
| Netplan wrapper | network_config | @igorpecovnik
| Install medusa container | install remove status help | @armbian
| Install syncthing container | install remove purge status help |
| Install owncloud container | install remove purge status help | @armbian
| Install netdata container | install remove purge status help | @armbian
| Change the background color of the terminal or dialog box | set_colors 0-7 | @Tearran
| Show general information about this tool | about_armbian_configng | @igorpecovnik
| Serve the edit and debug server. | serve_doc | @Tearran
| Update JSON data with system information | update_json_data | @Tearran
| pipeline strings to an infobox | show_infobox <<< 'hello world' ; | @Tearran
| Install readarr container | install remove status help | @armbian
| Install/uninstall/check status of uptime kuma container | install uninstall status | @armbian
| Install uptimekuma container | install remove purge status help | @armbian
| Stop hostapd, clean config | default_wireless_network_config | @igorpecovnik
| Update sub-submenu descriptions based on conditions | update_sub_submenu_data "MenuID" "SubID" "SubSubID" "CMD" | @Tearran
| Parse json to get list of desired menu or submenu items | parse_menu_items 'menu_options_array' | @viraniac
Expand All @@ -772,6 +877,7 @@ These helper functions facilitate various operations related to job management,
| Set system shell to BASH | manage_zsh enable|disable | @igorpecovnik
| Install sabnzbd container | install remove status help | @armbian
| Generate a Help message for cli commands. | see_cmd_list [category] | @Tearran
| Install mariadb container | install remove purge status help |
| Revert network config back to Armbian defaults | default_network_config | @igorpecovnik
| Install prowlarr container | install remove status help | @armbian
| freeze, unhold, reinstall armbian related packages. | armbian_fw_manipulate unhold/freeze/reinstall | @igorpecovnik
Expand Down
Binary file added tools/include/images/DAT001.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added tools/include/images/DAT005.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added tools/include/images/MED015.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added tools/include/images/MED020.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added tools/include/images/MED927.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 20 additions & 0 deletions tools/include/markdown/DAT001-footer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
=== "Configuration"

Database access configuration is done at first install:
- create root password
- create database
- create normal user
- create password for normal user

- Database host: `<your.IP>`

=== "Directories"

- Install directory: `/armbian/mariadb`
- Site configuration directory: `/armbian/mariadb/config`

=== "View logs"

```sh
docker logs -f mariadb
```
1 change: 1 addition & 0 deletions tools/include/markdown/DAT001-header.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Mariadb is one of the most popular database servers. Made by the original developers of MySQL.
19 changes: 19 additions & 0 deletions tools/include/markdown/DAT005-footer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
=== "Access to the web interface"

The web interface is accessible via port **8071**:

- URL: `https://<your.IP>:8071`
- Server: IP from server you are connecting to. If you have installed MariaDB via this tool, then this is `<your.IP>`
- Username: defined at SQL server install (MariaDb)
- Password: defined at SQL server install (MariaDb)

=== "Directories"

- Install directory: `/armbian/phpmyadmin`
- Site configuration directory: `/armbian/phpmyadmin/config`

=== "View logs"

```sh
docker logs -f phpmyadmin
```
1 change: 1 addition & 0 deletions tools/include/markdown/DAT005-header.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Phpmyadmin is a free software tool written in PHP, intended to handle the administration of MySQL over the Web. phpMyAdmin supports a wide range of operations on MySQL and MariaDB.
18 changes: 18 additions & 0 deletions tools/include/markdown/MED015-footer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
=== "Access to the web interface"

The web interface is accessible via port **8884**:

- URL: `https://<your.IP>:8884`
- Username/Password: There is none, but it is highly suggested setting a password for this container. To do this go to Actions -> Settings -> set user/password for the webUI.

=== "Directories"

- Install directory: `/armbian/syncthing`
- Site configuration directory: `/armbian/syncthing/config`
- Data directory: `/armbian/syncthing/data1` `/armbian/syncthing/data2`

=== "View logs"

```sh
docker logs -f syncthing
```
1 change: 1 addition & 0 deletions tools/include/markdown/MED015-header.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Syncthing replaces proprietary sync and cloud services with something open, trustworthy and decentralized. Your data is your data alone and you deserve to choose where it is stored, if it is shared with some third party and how it's transmitted over the Internet.
18 changes: 18 additions & 0 deletions tools/include/markdown/MED020-footer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
=== "Access to the web interface"

The web interface is accessible via port **443**:

- URL: `https://<your.IP>:443`
- Username/Password: admin / generate at first web interface login

=== "Directories"

- Install directory: `/armbian/nextcloud`
- Site configuration directory: `/armbian/nextcloud/config`
- Data directory: `/armbian/nextcloud/data`

=== "View logs"

```sh
docker logs -f nextcloud
```
3 changes: 3 additions & 0 deletions tools/include/markdown/MED020-header.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
Nextcloud gives you access to all your files wherever you are.
<br>
Where are your photos and documents? With Nextcloud you pick a server of your choice, at home, in a data center or at a provider. And that is where your files will be. Nextcloud runs on that server, protecting your data and giving you access from your desktop or mobile devices. Through Nextcloud you also access, sync and share your existing data on that FTP drive at the office, a Dropbox or a NAS you have at home.
18 changes: 18 additions & 0 deletions tools/include/markdown/MED027-footer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
=== "Access to the web interface"

The web interface is accessible via port **7787**:

- URL: `http://<your.IP>:7787`
- Username/Password: admin / admin

=== "Directories"

- Install directory: `/armbian/owncloud`
- Site configuration directory: `/armbian/owncloud/config`
- Data directory: `/armbian/owncloud/data`

=== "View logs"

```sh
docker logs -f owncloud
```
1 change: 1 addition & 0 deletions tools/include/markdown/MED027-header.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
ownCloud is a free and open-source software project for content collaboration and sharing and syncing of files in distributed and federated enterprise scenarios.
Loading

0 comments on commit 89770f6

Please sign in to comment.