© 2017. Earlham Institute, Norwich, UK, Ontario Institute for Cancer Research, Toronto, Canada
MISO project contacts: Robert Davey, Morgan Taschuk
MISO is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
MISO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with MISO. If not, see http://www.gnu.org/licenses/.
The simplest way to get MISO up and running quickly is to use Docker. Images of the most recent MISO releases are available on Docker Hub in misolims/miso-lims. The Docker container is intended as a demonstration and not a permanent installation. Please note that shutting down the Docker container deletes all MISO data, and restarting the Docker container starts up with a fresh MISO. If you wish to store your data longer-term when testing out MISO, please follow the instructions for Running an Instance of MISO below.
To use it:
- Install Docker 1.9.1+
docker pull misolims/miso-limsdocker run -p 8090:8080 -d -t misolims/miso-lims
Navigate to http://localhost:8090 to login to miso with the credentials admin/admin.
An older version of MISO is available in our our virtual machine image with everything preinstalled. A VirtualBox instance is available with a self-contained MISO installation and MySQL database server, fully configured and can be used out-of-the-box.
To use it:
- Download VirtualBox software from: https://www.virtualbox.org/
- Download the MISO OVA: https://repos.tgac.ac.uk/miso/latest/MISO_Image.ova
- Import this OVA file into VirtualBox via File → Import Appliance. You may have to select Bridged Adaptor instead of NAT in the network settings.
- Start the instance. Starting the appliance will result in an Ubuntu virtual
machine complete with all MISO’s prerequisites pre-installed. The login for the
virtual image is
miso/misoadmin. - Start MISO server by using
./misoStart.shand then open the browser and go http://localhost:8080/ - Log in to MISO using
admin/admin. Only some simple configuration for certain elements is required, such as Sequencer References, Printers and any additional users and groups.
There is a tutorial available for introducing new users to MISO's functionality. Some of the resources (MISO URL, ways of contacting the MISO administrators) are specific to Ontario Institute for Cancer Research, but this can be changed by forking and configuring the tutorial repository.
To run your own MISO instance in the long term, download the latest release.
Installation and configuration details can be found in the MISO installation guide.