Awesome
Unraid Oh My Zsh Plugin
This plugin adds convenient aliases and functions for managing your Unraid server directly from the command line.
Installation
-
Clone this repository into your Oh My Zsh custom plugins directory:
git clone https://github.com/donbuehl/zsh-unraid.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/unraid
-
Add
unraid
to your plugin list in your.zshrc
file:plugins=(... unraid)
-
Reload your
.zshrc
or restart your shell:source ~/.zshrc
Features
Array Management
array-start
: Start the Unraid arrayarray-stop
: Stop the Unraid array
User Scripts
list-scripts
: List all user scriptsrun-script <script-name>
: Run a specific user script
Docker Management
docker-list
: List running Docker containersdocker-start <container>
: Start a Docker containerdocker-stop <container>
: Stop a Docker container
VM Management
vm-list
: List all VMsvm-start <vm-name>
: Start a VMvm-stop <vm-name>
: Stop a VM
Quick Directory Navigation
cdboot
: Change to /bootcdextras
: Change to /boot/extrascdappdata
: Change to /mnt/user/appdatacddomains
: Change to /mnt/user/domainscdisos
: Change to /mnt/user/isoscdshare
: Change to /mnt/user/sharecddisks
: Change to /mnt/disks
Plugin Directory Navigation
cdplugin <plugin_name>
: Change to the plugin's directory (checks config first, then emhttp)cdpluginconf <plugin_name>
: Change directly to the plugin's config directorycdplugincode <plugin_name>
: Change directly to the plugin's code directory
System Information
unraid_info
: Display a summary of Unraid system information
Notes
- Some features may require additional plugins or configurations on your unRAID system.
- This plugin is designed to work with Unraid 6.x and later versions.
- Always exercise caution when using commands that modify your array or system configuration.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE.md file for details.