iSCSI4NASDocs

Everyday use

Startup and Automount: three separate switches.

What happens after you log in is controlled in three places: macOS starts the app, a target connects automatically and Automount presents a specific LUN or mounts a volume. Turn on only what you really need.

The three switches

SwitchWhereEffect
Start app at loginSettings → General → Startup & QuitmacOS starts iSCSI4NAS after you log in.
Auto-connect targetTargets → Network → BehaviorThis saved target connects at app launch.
AutomountAutomount → Add…A specific LUN is attached as a disk or a volume is mounted under /Volumes/.

For a volume right after login you need the app launch and an Automount rule. The Automount rule connects its target itself. Auto-connect at app launch is meant for targets that should connect without an Automount rule.

1. Start the app at login

Open Settings → General → Startup & Quit and turn on Start iSCSI4NAS at login. If macOS asks for login item approval, confirm it in System Settings.

You can also turn on Require authentication at startup. The app then waits for Touch ID or your login password before the first connection.

Startup and Quit in the settings of the live demo
DemoApp launch after macOS login.

2. Set the target connection

Select a saved target and open Network → Behavior. There are two switches:

Both switches apply per target. With several targets, set each one. A connected target attaches the LUN as a disk. The volume in Finder comes with Mount or an Automount rule.

3. Add a LUN or volume to Automount

  1. Mount the target manually once. This lets iSCSI4NAS learn the available LUNs and volumes.
  2. Open Automount → Add… and choose the volume or LUN you want. If the entry is missing, mount the target and click Refresh.
  3. For a LUN the app later connects the target and attaches exactly this LUN as a disk. For a volume you also set the name under /Volumes/.
  4. Save. The rule applies from the next app launch.
Adding an Automount rule in the live demo
DemoAn Automount rule applies to one specific LUN or volume.
LUN or volume?

If you choose the LUN, iSCSI4NAS presents the disk and macOS mounts an existing file system at its own discretion. If you choose the volume, you get a fixed mount point under /Volumes/. For backups and scripts the volume is the better choice.

Unmounted by hand?

If you unmount or disconnect a LUN yourself, Automount skips its entry and shows Paused · unmounted manually. Mount it once and Automount takes over again.

Check after the next login

Go through these five questions in order. The first answer that does not fit shows you where to look:

  1. Is the app running?
  2. Does Automount show the entry without Paused?
  3. Is the target connected?
  4. Is the LUN listed under Disks?
  5. Is the volume mounted in Finder?