Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3


Table of Contents

Installing OpenIndiana

You need OpenIndiana runs on a PC (32 or 64-bit) with at least 512 768 megabytes (MB) of RAM (768 megabytes 1 gigabyte (GB) recommended), and 4 gigabytes of available disk space (2 gigabytes for the text installer) of available disk spaceserver install). You can also use virtual machine software such as VirtualBox, Parallels or VMware.



To create a bootable USB device, you must use a USB storage device exactly 1 gigabyte (GB) or larger.
To create a live USB in with Windows, use the OpenSolaris Live USB Creator.
To create a live USB in with illumos, Solaris or OpenSolaris, you may use the usbcopy tool.
To create a live USB on any Unix-like system (including Mac OS X), download :

  1. Download both the standard live USB
and the
  1. file
    1. For OpenIndiana images before OpenIndiana Hipster 2016.10 snapshot you should have used special header file:
      1. For USB images of 1GB or less (e.g. the Text Installer), use the 1G.header file
and run the following commands: rmformat -l
<list of removable devices; "Logical Node" field is the path to the raw USB storage device>
cat 1G.header <USB image file> | dd bs=1024k of=<path to raw USB storage
      1. .
      2. For USB images exceeding 1GB (e.g. the Live Installer), be sure to use the 2G.header file.
  1. Locate the path to your USB storage device.
    • This will typically be /dev/rdsk/c*t*d0p0 on illumos/Solaris (rmformat -l), /dev/sd* on Linux (fdisk -l), /dev/da* on FreeBSD (camcontrol devlist), or /dev/disk* on OS X (diskutil list).
    • Use the whole device, not including a partition or slice number (sda, not sda1; c0t0d0p0, not c0t0d0p1).
      • In illumos, the whole disk device name is depending on partition type; on x86, the whole disk name ends with p0, in case the GPT (EFI) partition, the whole disk device name ends with dX, on sparc, the disk has usually VTOC partition and whole disk device name usually ends with s2. Note, if on x86 MBR+VTOC is used, then the s2 device is addressing Solaris2 MBR partition, not whole disk.
    • Make sure you identify the correct storage device, as any data on the device will be erased.
  2. Desktops may automatically mount removable devices. Make sure no filesystems located on the device are mounted prior to the next step.
    • Select any desktop icons for the USB device and issue an Eject or Unmount command.
    • Use the mount command to list mounted filesystems. If any filesystems are located on the USB storage device, they must be unmounted.
    • Use umount <path> to unmount a filesystem, or rmumount <path> on illumos/Solaris, and diskutil unmountDisk <path> on OS X.
  3. Run the following command (as root or with appropriate privileges): dd if=<live USB image file> of=<path to raw USB storage device>
    1. Note, that for OpenIndiana images before 2016.10 you should have used special header file: cat <1G or 2G header> <live USB image file> | dd bs=1024k of=<path to raw USB storage device>
  • Boot your computer with the medium inserted. You may have to change the boot device order in your BIOS configuration.


    In VirtualBox 3.2 or later, "Use host I/O cache" must be enabled in the emulated storage controller used by the virtual machine to successfully boot OpenIndiana.

  • When you see a menu, press Enter to start OpenIndiana on your computer. As it runs, you will be prompted with a few questions.
  • You should eventually be presented with a desktop. You can use the Device Driver Utility to check if your hardware requires additional drivers.
  • Click on Install OpenIndiana to permanently install OpenIndiana on your computer.



If you see a "login:" prompt after selecting your keyboard and language and no desktop appears after several seconds, there may be a problem with the drivers for your graphics hardware. Please let us know if this happens. Include error messages you see on the console, and the output of the command svcs -xv and the contents of the file /var/log/Xorg.0.log if possible.

The login for the text session is username jack, password jack. The installer is graphical and requires X11, although it is possible to use it over a network with SSH X forwarding if you enable SSH. For administrative access, prepend your commands with pfexec.

Creating the dd USB Live Image from OS X

Using Mac OS X to create the USB Live Image of OpenIndiana? These instructions may help.

You'll need at least a 2GB USB stick; this example uses a 4GB.

OS X includes all tools needed:

  • cURL - the - excellent! -tool for download (to know it is to love it!: cURL - by Daniel Stenberg)
  • md5 - to checksum the download
  • diskutil - to manage your disks
  • dd - writes the bootable image to USB stick

1. Download the dd image, and the corresponding checksum file. Be sure to download the image 'writable with dd'!

Code Block
$ curl -OL
$ curl -OL

2. Checksum your download - be sure you have a match!

Code Block
$ cat oi-dev-148-x86.usb.writable-with-dd.md5

$ md5 oi-dev-148-x86.usb.writable-with-dd
MD5 (oi-dev-148-x86.usb.writable-with-dd) = c2b907c428eaf3aa624fc057e7849c73

3. After plugging in the USB device you will use - and assuming it's been formatted, it will appear in diskutil.

In our example, we've used a 4GB USB stick, disk2, with a 1GB FAT_16 partition:


CAUTION: dd will erase all partitions, and all data, on this stick. Be sure of the disk# you are using!

Code Block
$ diskutil list
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:      GUID_partition_scheme                        *2.0 TB     disk0
   1:                        EFI                         209.7 MB   disk0s1
   2:                  Apple_HFS iMac                    2.0 TB     disk0s2
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:     FDisk_partition_scheme                        *1.0 GB     disk2
   1:                 DOS_FAT_16 DATADISK                1.0 GB     disk2s1

4. unmount the USB stick, if mounted:

Code Block
$ diskutil unmountDisk /dev/disk2
Unmount of all volumes on disk2 was successful

5. Write the image using dd; we timed it:

Code Block
$ time dd if=oi-dev-148-x86.usb.writable-with-dd of=/dev/disk2

2160767+0 records in
2160767+0 records out
1106312704 bytes transferred in 1379.597249 secs (801910 bytes/sec)

real	23m0.001s

Welcome to OpenIndiana! Enjoy!