This guide takes you from the first ISO boot to your first usable file share, in a few steps. Allow about 20 minutes. For per-platform details and full requirements, see the installation guide; for daily use, the administration guide.
What you need#
- A virtual machine or server: 2 vCPU, 8 GB RAM minimum (4 vCPU / 16 GB or more recommended).
- Two disks: one for the OS (≥ 32 GB) and at least one separate data disk (≥ 10 GB) for the storage pool.
- The Caelum ISO image (1.4 GB), downloaded from the portal.
- A DHCP network, or the settings of a static IP (address, netmask, gateway, DNS) to enter during installation.
Step 1 — Install the system (ISO wizard)#
- Create the VM for your hypervisor (see the installation guide for the exact settings for VMware, Proxmox, Hyper-V, KVM).
- Mount the Caelum ISO as a CD/DVD drive and boot from it.
- Follow the 5-step text wizard: keyboard, appliance name, network (DHCP or static IP), OS disk, confirmation. It then writes the system: allow about 3 minutes.
- When done, the VM reboots and shows its IP address in the console.
To avoid any ambiguity about the target disk, install first with a single disk (OS), then add the data disk(s) afterwards.
Step 2 — Initial configuration (web wizard)#
- From a browser, open
https://<appliance-ip>/setup. - Accept the browser warning (the certificate is self-signed by default).
- Fill in, in order:
- the appliance name and time zone;
- the network (keep the configuration set during installation, or switch to DHCP / static IP);
- the administrator account (login + password);
- the storage pool (select the data disk(s); the ZFS pool is created);
- optionally the Active Directory domain;
- the telemetry choice (checked by default, untick to decline).
At the end of the wizard, the appliance is operational.
The pool topology (mirror / raidz) is fixed at creation: size your disks accordingly.
Step 3 — Create your first share#
- Log in to the interface (
https://<ip>). It opens in English; the EN / FR selector in the top bar changes the language. - Storage → Volumes menu, New volume button: give it a name (per project or per team), a quota, and optionally a default archiving destination and Windows "Previous versions".
- Storage → Shares menu, New share button: choose the volume, the protocols (SMB and/or NFS), the read-only option if needed, and the allowed accounts / groups (local or domain).
- Click Create the share. The share is served immediately.
Step 4 — Access it from a workstation#
- Windows (SMB): in File Explorer, open the share path and authenticate (domain or local account).
- Linux/Unix: mount the share over SMB (CIFS) or via the NFS export.
# Windows — paste into the File Explorer address bar
\\<appliance-ip>\<share-name>
# Linux — SMB (CIFS) mount
sudo mount -t cifs //<appliance-ip>/<share-name> /mnt/caelum \
-o username=<user>
# Linux — NFS mount
sudo mount -t nfs <appliance-ip>:/<nfs-export> /mnt/caelum
You can now drop files in. That is your first Caelum share.
The interface certificate is self-signed by default: your browser will show a warning on first connection, which is normal. You can install a trusted certificate later from the administration interface.
Next steps (optional)#
Once the share is in place, you can gradually enable the rest:
- Find the appliance on the network — no action required: Caelum appears on its own in the Windows "Network" view and in the macOS Finder (WS-Discovery / mDNS discovery is active by default).
- Previous Versions (Windows) — enable them with a single checkbox in the volume's edit window: scheduled snapshots and Windows exposure are provisioned at once. See the administration guide.
- Snapshots & replication — schedule ZFS snapshots and replicate to a second site. See the administration guide.
- Cloud archiving (S3) — declare a cloud destination then an archive policy to archive cold files while keeping transparent access. See the "archive cold data" use case.
- Migrate from an existing NAS — use the migration assistant to copy data and rights. See the "migrate" use case.
- Disaster recovery (DR) — replicate to a remote site. See the "DR" use case.
- License — the trial starts automatically (30 days, no Internet needed); install a license in Settings → License → Install a license when you are ready. See the FAQ.