source: main/trunk/greenstone3/README-Ubuntu-VM.txt@ 36484

# Create a VM in VirtualBox

Ubuntu 22 (Jammy Jellyfish) VDI was downloaded from:
    https://www.osboxes.org/ubuntu/

Machine created with:
  Settings -> System -> Processor -> VT-x/AMD-V (checked on)
  (required if using the Greenstone3 docker extension)
  
Launch VM


# Guest Desktop OS Customization and Setup

Pin terminal to taskbar

Use Taskbar search for 'privicy' and select 'screen'
  => switch off lock-screen for (both) when going blank, and suspend
  
    sudo apt-get update

Then the desktop GUI update manager (Software Updater) opened up 
  => chose yes to update


Even with a VDI with Guest Additions, it does not always auto-scale the
desktop to fill the screen.  It like makes the desktop bigger than the login 
screen, but typically only around 75% of the available screen size.

Have found the re-installing Guest-Editions seems to 'flush' this out.

    sudo apt-get install build-essential

VB Device -> Insert Guest Additions ...

Right-click on 'autorun.sh' => enter admin password

Reboot


# Greenstone3 Installation and Setup

    sudo apt-get install subversion emacs-nox

    cd /opt
    sudo svn co https://svn.greenstone.org/main/trunk/greenstone3 greenstone3-svn

    sudo adduser osboxes www-data
    newgrp www-data   
    sudo chown -R osboxes:www-data greenstone3-svn
    chmod -R g+w greenstone3-svn
    find greenstone3-svn -type d -exec chmod g+s {} \; -print

    cd greenstone3-svn

    ./gs3-check-cli.sh
    

# Extras

    sudo apt-get install mlocate

    sudo apt-get install git
    sudo apt-get install zsh