Introduction

Welcome to the Complete SmartOS Installation Tutorial. If you thought installing an operating system was as exciting as watching paint dry, think again! SmartOS, Joyent’s open-source datacenter virtualization platform, brings ZFS, KVM, and Zones together in one slick, illumos-based package. Buckle up for an in-depth, step-by-step guide packed with practical tips—and a pinch of humor—to get you from zero to ZFS wizard.

1. System Requirements

Before you dive in, make sure your hardware isn’t from the Jurassic era. Here’s the basic checklist:

2. Downloading the SmartOS Image

Head over to the official Joyent site to grab the latest SmartOS image:
https://smartos.org. You’ll see several options:

• ISO Installer ndash traditional DVD/virtual CD
• USB/TFTP Image ndash for USB sticks or network boot
• OVA Template ndash ready for VMware/VirtualBox

For physical or KVM hosts, the ISO Installer is usually your best friend.

3. Creating Your Installation Media

3.1 Burning the ISO (Virtual Machine)

Simply attach the ISO to your VM’s CD drive and boot. No rocket science here.

3.2 Writing the ISO to USB (Physical Machine)

1. Insert a USB stick (≥1 GB).
2. Identify your device: lsblk or fdisk -l.
3. Run:

   dd if=smartos.iso of=/dev/sdX bs=4M status=progress  sync
         

   Warning: Replace /dev/sdX with your USB device. Double-check or wave goodbye to your data.

4. Safely eject: eject /dev/sdX.

4. Booting the Installer

Reboot your system and set your BIOS/UEFI to boot from the USB or CD. You’ll arrive at the SmartOS boot prompt:

SmartOS Boot:
> 1) Boot SmartOS Install Media
> 2) Boot to Shell
Enter choice (1-2): 1
  

Press 1 and watch the magic unfold.

5. Partitioning and Disk Setup

SmartOS uses ZFS by default. If you love snapshots and compression (who doesn’t?), stick with ZFS. The installer will walk you through:

• Choosing the target disk
• Creating a GPT label
• Auto-configuring a ZFS pool named rpool

If you prefer manual control, drop to shell (boot -s) and use zpool and zfs commands. But remember: with great power comes great responsibility!

6. Initial Configuration

• Timezone: Select from the list or enter region manually.
• Networking: Configure DHCP or static. Example for static:

  ifconfig e1000g0 plumb
  ifconfig e1000g0 192.168.1.100 netmask 255.255.255.0 up
  route add default 192.168.1.1
        

• Hostname: Choose wisely (avoid embarrassing names in logs!).
• Root Password: Make it strong enough to fend off toddlers.

7. Installing the OS

Once you’re satisfied with your settings, confirm and let the installer run its course. You’ll see ZFS datasets being created and the base illumos system unpacked. Grab a coffee or perform a quick dance—this step takes a few minutes.

8. Reboot and First Boot

After installation:

1. Remove install media.
2. Reboot: init 6.
3. Watch for the new SmartOS prompt:

   SmartOS (live) console login: root
         

4. Login with the root password you set earlier.

9. Post-Installation Configuration

9.1 SMF Services

SmartOS uses SMF (Service Management Facility). Check your services:

svcs -a  egrep svc:/networksvc:/system
  

To restart a service:

svcadm restart svc:/network/physical:e1000g0
  

9.2 Zone KVM Setup

SmartOS shines with lightweight Zones and full virtualization via KVM. Quick start:

• Create a SmartMachine image: imgadm import -f https://us-east.manta.joyent.com/joyent/public/os/smartos
• Instantiate a zone:

  vmadm create <
  

• List running VMs: vmadm list

10. Troubleshooting Tips

• No network? Ensure /etc/hostname. files are correct and svcadm enable network/physical.
• Boot stuck? Boot verbose (-v) to see where it hangs, then Google like a pro.
• ZFS errors? Check zpool status and scrub with zpool scrub rpool.

Conclusion

Congratulations! You’ve just navigated a full SmartOS installation—from ISO download to spinning up Zones and KVM guests. May your ZFS snapshots be plentiful and your kernels stable. If something goes sideways, just remember: reboot, read logs, and ask in the community on
SmartOS Community. Happy hypervisoring!