Unraid GUI Modification?


Recommended Posts

I'm currently making a custom unRAID box consisting of an 'Apple xServe RAID'  'Both Hardware & Software Implementation'.... My xServe has served it useful life '2002 - 2015' and i cannot expand without burning a massive hole in my pocket :D...

 

I asked one of the admins 'jonp' about customizing the GUI for my needs and 'He / She' Suggested post here for some help?.

What I am trying to achieve here is a GUI that looks like the xServe Raid but has a complete custom overhaul to suite the xServe box... instead of the 'Generic unRAID' look.

 

What i would like to know

 

    1: What would i need to Achieve this....  Ideal OS, Any Packages or specific Applications

    2: How I would go about  Achieving this..

I am not afraid of a learning challenge  ;D

 

If i am able to achieve this I would like to document the "procedure" on the forum for others to attempt in the future  with 'Admins Permission'... I "Procedure" as it may be subject to change in the future versions of unRAID... I don't know....

 

Cheers

Steve

Link to comment

The look and feel of the GUI can be adjusted by changing the css style files.

 

Currently there are two color themes: white and black, the css file naming is accordingly.

 

Each color theme uses two css files to do the complete GUI make-up. E.g the white theme uses: default-white.css and dynamix-white.css.

 

These files are located in the folder styles.

 

If you want to learn more about css coding, a good place to start is http://www.w3schools.com/

 

Link to comment

@bonienl

 

I have a copy of the Dynamix webGui repo on my system and have found the styles folder... is there any software i can load this up on/in so im able to get a preview ?

 

My next Question is .. where about on an unRAID Server can i locate this folder & Am i able to make any 'Live Modifications' ?

 

Cheers

Steve

Link to comment

Hi All,

 

Right after spending a few days waiting for a reply to my posts and pm I've decided to go digging round the depths of the unraid software, I have finally found the place 'I think' where the webUI is Stored 'Where emhttp loads up its skin'.

 

-- log into unraid

-- navigate to the following

-- /usr/local/emhttp/plugins/webGui

 

Can anyone confirm if i edit the styles in the styles folder, unRaid will indeed change its looks and retain them after a reboot ?

 

Cheers

Steve

 

Link to comment

Hi All,

 

Right after spending a few days waiting for a reply to my posts and pm I've decided to go digging round the depths of the unraid software, I have finally found the place 'I think' where the webUI is Stored 'Where emhttp loads up its skin'.

 

-- log into unraid

-- navigate to the following

-- /usr/local/emhttp/plugins/webGui

 

Can anyone confirm if i edit the styles in the styles folder, unRaid will indeed change its looks and retain them after a reboot ?

 

Cheers

Steve

I can navigate to /usr/local/emhttp/webGui which is a link to /usr/local/emhttp/plugins/dynamix, and there is a styles folder there.

 

I can confirm that changes to anything in /usr WILL NOT survive a reboot, as all of the unRAID OS files are in RAM and unpacked fresh from the flash drive on each boot.

 

The usual way to get something like this to survive reboot is to add something to the /boot/config/go script which runs on boot to copy files into the OS locations.

 

Whether editing the styles as you suggest will have the desired effect, I will let someone else comment on, but you could just try it yourself, since it won't survive a reboot anyway.

Link to comment

@trurl

 

I understand that ..

 

Do you know where on the flash drive the files are stored?, If I'm able to edit those unRaid / emhttp will load the Edited files into the ram?

 

Cheers

Steve

 

-- EDIT --

 

After a bit more digging around am i safe to assume that this the files that emhttp use / loads are in this ?  'flash\config\plugins\dynamix\dynamix-2015.01.21.tar.gz

Link to comment

@trurl

 

I understand that ..

 

Do you know where on the flash drive the files are stored?, If I'm able to edit those unRaid / emhttp will load the Edited files into the ram?

 

Cheers

Steve

 

-- EDIT --

 

After a bit more digging around am i safe to assume that this the files that emhttp use / loads are in this ?  'flash\config\plugins\dynamix\dynamix-2015.01.21.tar.gz

I don't have that file on my flash, and since it looks like it has a January date, I am guessing that is something left over from something else you have done.

 

I know exactly where they are though. They are in the archive which is named bzroot on your flash drive, which is one of the main components of the unRAID download, and one of the main files that is replaced when a new version is released. That is what I meant by the OS is unpacked fresh on each boot.

 

From 7zip I can drill down into that file and see them at bzroot\bzroot~\usr\local\emhttp\plugins\dynamix\styles\

 

If you want to take the approach of modifying this archive, then of course you will have to do it again each time a new version is released. There are some who have taken this approach to install special drivers for tv tuner cards, for example.

 

Or put your changes on your flash somewhere and overwrite the unpacked files after boot with the go script as I already mentioned.

 

Either way you will be running an unsupported system and if you have any issues, the first thing you will have to do is revert to stock to get any help with it.

Link to comment

I'm currently making a custom unRAID box consisting of an 'Apple xServe RAID'  'Both Hardware & Software Implementation'.... My xServe has served it useful life '2002 - 2015' and i cannot expand without burning a massive hole in my pocket :D...

 

I asked one of the admins 'jonp' about customizing the GUI for my needs and 'He / She' Suggested post here for some help?.

What I am trying to achieve here is a GUI that looks like the xServe Raid but has a complete custom overhaul to suite the xServe box... instead of the 'Generic unRAID' look.

 

What i would like to know

 

    1: What would i need to Achieve this....  Ideal OS, Any Packages or specific Applications

    2: How I would go about  Achieving this..

I am not afraid of a learning challenge  ;D

 

If i am able to achieve this I would like to document the "procedure" on the forum for others to attempt in the future  with 'Admins Permission'... I "Procedure" as it may be subject to change in the future versions of unRAID... I don't know....

 

Cheers

Steve

If you don't what to put a bunch of copy commands in your go file or you have a bunch of files you want to edit and have reinstalled on reboot I would do this:

 

Create a directory in the root of your flash drive named custom.  In the custom directory mirror the path of the css files for dynamix. So create a directory structure of /usr/local/emhttp/plugins/dynamix/styles in the custom directory. Copy the css file to this location and edit. You can mirror any other files in this directory structure you want to make changes to.

 

Then log in to unRAID.  And do this.

cd /boot/custom
makepkg /boot/extra/custom.txz

Select yes when asked by makepkg. Now you'll have a custom package with all your edits install on reboot.

 

Another thing you can do is what I do when working on an update for a plugin I've created.  Take my apache plugin for instance.  It gets installed at /usr/local/emhttp/plugins/apache.  I copy the apache directory to /mnt/cache/.plugins/apache. And I have a script in the root of my flash drive named apache.sh

rm -rf /usr/local/emhttp/plugins/apache
ln -sfT /mnt/cache/.plugins/apache/ /usr/local/emhttp/plugins/apache

This removes the emhttp apache directory and creates a symlink in its place to my .plugins apache directory. Where I edit and view in real time. If I reboot the server I just manually execute /boot/apache.sh and resume editing. Any changes I had made before reboot are saved on my cache drive.

 

You would want to be very careful doing this on the dynamix directory. If you delete or mess it up your webgui might not work.

Link to comment

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.