You can specify a custom graphic to appear as the background to the VMware Integrated OpenStack dashboard log-in page.


  1. Load your custom graphic file in the /home/viouser/custom/horizon/ directory in your VMware Integrated OpenStack deployment.

    This directory is the default directory for graphic files in the VMware Integrated OpenStack dashboard.

  2. Open the /home/viouser/custom/horizon/_styles.scss file in a text editor.
    1. Uncomment the .login-bg parameter.
      .login-bg {
        height: 100%;
        body {
          background: #1D2226 url("/static/themes/vmware/CUSTOM-BACKGROUND-IMAGE.jpg") repeat-x 45% 0 !important;
          background-size: 100% auto !important;
          color: black;
    2. Modify the .login-bg parameter to reference your custom background graphic file.
    3. Save the _styles.scss file.
  3. Implement the custom.yml file.
    sudo mkdir -p /opt/vmware/vio/custom
    sudo cp /var/lib/vio/ansible/custom/custom.yml.sample /opt/vmware/vio/custom/custom.yml
  4. Open the /opt/vmware/vio/custom/custom.yml file in a text editor.
    1. Uncomment the parameter that enables the custom.yml settings to override the default style sheet settings.
      # overwrite the _styles.scss file in the VMware theme
      horizon_custom_stylesheet: "/home/viouser/custom/horizon/_styles.scss"
    2. Uncomment the parameter that specifies the custom directory to contain the custom graphic file.
      # copy all custom images (or other files) to be accessible in horizon
      # IMPORTANT: this line must end with a "/" in order to place the files
      # in the right location for horizon
      horizon_custom_directory: "/home/viouser/custom/horizon/" 
    3. Save the custom.yml file.


Your custom background image appears on the dashboard log-in page the next time you start a session.