Skins
Changing the Cortex interface is a convenient way to rearrange the layout or rebrand the Cortex look and feel to your liking. Skinning and skin packaging is explained in much greater detail in the skinning guide.
The skins page displays all skins installed on your Cortex cluster along with forms to edit, delete them, or set them as the system default skin along with a list of servers in the cluster that the skin is installed on. Skins marked with an asterisk are the default skin for that server.
Cortex ships with two default skins. One called “Cortexâ€, which is the default skin. The other is a debranded version of the default skin which does not contain the Insomnia365 logo.
|
While it is possible to edit the default Cortex skins directly on the server we highly recommend against it. The Cortex and debranded skins are frequently changed when a Cortex update is released. Any changes made to these skins are overwritten after an update. Please copy, package, and install your custom skin through the skin utilities to keep them safe. |
Adding Skins
Underneath the skin list on the skins page is the form to add a skin to your server or cluster. Fill out the following information:
| Name | The name of the skin. |
| Background color | The skin controls all pages served by Cortex except for the real-time pages such as engine installation, network tools and the like. The background color is a hexadecimal #RRGGBB color for these real-time pages. |
| Skin File | Click browse and locate the skin file on your local computer to upload. Under the add form are a series of guidelines the skin file must follow. This is explained in further detail in the Cortex skinning guide. |
| Server | Select which server to add the skin to, or choose to add it to all servers. |
Click the add icon to upload the skin to your Cortex server. If you choose to add it on a remote cluster node Cortex will transfer the file to the other nodes. Once this is complete the skins page will refresh with the new skin in the skin list.
Editing Skins
Click the edit skin icon next to the skin you wish to edit to bring up the edit skin form. This form is identical to the add skin form with the exception that any skin changes you make will replicated across your Cortex cluster. If you have made any changes to the skin files themselves you will need to re upload your skin package here. Click save to update the skin on the cluster and return to the skins page.
The skin edit form is not available for the default Cortex skin.
Setting the Default Skin
If you have more than one skin installed on the server you can assign one of them to be the default system skin. If a user has their own skin assigned to them they will see that skin after logging into Cortex. Cortex chooses which skin to display for the user by first checking the user's default skin. If no user default skin is set then it will display the system default, which is set here.
To set a default system skin, click the set default icon next to your desired skin. On the next page check which servers you want to assign the skin to and click continue. Cortex will set your default skin then return you to the skins page
|
If your new default skin has a bug in it and renders Cortex unusable check our troubleshooting section for how to reset your skin! |
Removing Skins
Click the delete icon next to the skin you want to remove. Cortex will bring you to a page asking which server you want to remove the skin from. Check the appropriate boxes and hit continue. Cortex will then remove the skin from your selected servers and reassign user skins to the default skin for any users that used this skin. Once this is complete you’ll be brought back to the skinning page.
The delete icon is grayed out and unusable for the default Cortex skin.
