Development use only!
https://git.minenet.at/ich777/unraid-versionchange/raw/branch/master/unraid-versionchange.plg
Settings:
Edit the file /boot/config/plugins/unraid-versionchange/settings.cfg
to you preference, available options are:
Variables | Description | Default |
---|---|---|
BASE_URL | Base URL from where the release files are downloaded | https://fastdl.minenet.at/Unraid |
INDEX_URL | Base URL where the available releases are listed (this has to be a simple directory index listing from a web server like nginx) | https://fastdl.minenet.at/Unraid |
CACHE_BUILDS | Set to the preferred number of builds that you want to cache locally (set to 0 to don't cache builds and/or delete already cached builds if enabled before) |
0 |
CACHE_PATH | Set your preferred cache path if you plant to mount the CACHE_PATH through UnassignedDevices eg: /mnt/remotes/FOR.EIG.NIP.XXX_DATA/versionchange <- this has to be a absolute path see example below. The value default defaults to: /boot/config/plugins/unraid-versionchange/cached_builds |
default |
CACHE_MOUNT | Set this variable to the source from your Unassigned Devices share (eg: //FOR.EIG.NIP.XXX/DATA) and the plugin tries to mount the share through Unassigned Devices, otherwise set to: false (depends on CACHE_PATH ) |
false |
INITIAL_UPDATE | Update releases when visiting the plugin page for the first time. Set to 0 to disable, set to 1 to enable and pull the available releases from the INDEX_URL (depends on CACHE_BUILDS if not available falls back to cached builds), set to 2 to build a index from the locally cached releases (depends on CACHE_BUILDS ) |
0 |
LIST_STYLE | Set to 1 to get a compiled list/drop-down from all builds or set to 0 to get two drop-downs where you first have to choose the release channel and afterwards the release |
0 |
QUICK_LINK | Set to 1 to either modify the version string in the header below the Unraid logo to make it clickable (up to unRAID 6.13.0-beta0.22) or a additional "Download" icon in the Menu bar (starting with unRAID 6.13.0-beta0.23) to get to the plugin page, set to 0 to disable |
0 |
GLOBAL_CONFIG | If set to 1 you have to put a settings.cfg in your CACHE_PATH to pull the settings from there, useful if you want to update multiple servers |
0 |
Recommended config to share files and settings across multiple servers
- On the server that will host files:
- Create (for example) /mnt/user/UnraidData/versionchange/settings.cfg with your preferred settings:
BASE_URL=https://fastdl.minenet.at/Unraid
INDEX_URL=https://fastdl.minenet.at/Unraid
CACHE_BUILDS=999
CACHE_PATH=/mnt/user/UnraidData/versionchange
CACHE_MOUNT=false
INITIAL_UPDATE=1
LIST_STYLE=1
QUICK_LINK=1
GLOBAL_CONFIG=1
- On all systems:
- Mount that share using UD
- Open /boot/config/plugins/unassigned.devices/samba_mount.cfg and find the entry that you just mounted. Note the name in brackets, i.e. [//192.168.0.1/versionchange]. This will be your CACHE_MOUNT value below
- Install the plugin
- Modify /boot/config/plugins/unraid-versionchange/settings.cfg to be:
BASE_URL=https://fastdl.minenet.at/Unraid
INDEX_URL=https://fastdl.minenet.at/Unraid
CACHE_BUILDS=999
CACHE_PATH=/mnt/remotes/192.168.0.1_versionchange/versionchange
CACHE_MOUNT=//192.168.0.1/versionchange
INITIAL_UPDATE=1
LIST_STYLE=1
QUICK_LINK=1
GLOBAL_CONFIG=1
(The first four entries are all that really matter, the rest will be overridden by the global config)
When there is a new release, from any system:
- Click the version number in the Unraid header (the remote share will automatically be mounted if needed)
- Click "Update Releases"
- Find the appropriate release and click "Download"
Then to upgrade/downgrade a server:
- Click the version number in the Unraid header (the remote share will automatically be mounted if needed)
- Pick the new version and Install
Note:
- Use care when upgrading, as this plugin bypasses any version-specific logic used in the normal installation plugin
- Use care when downgrading, any version-specific or feature-specific configuration changes are out of scope for this plugin and must be applied manually
Description
Languages
Shell
100%