Check the image
Verify the SHA-256 checksum and the GPG signature by following the instructions on the images page.
Guide · version 1.2.1
Installation
Use the NVG Install image to install the system without internet. After booting from the USB drive, open the installer in the terminal. The Live image is for trying the system and does not include the installer.
Preparation
Before you start
Check the image availability on the download page and back up the files you want to keep. The default installation erases the chosen disk. The installer reports the required space before continuing.
Installation media
Preparing the USB drive
Write it to the USB drive
Use a tool that supports hybrid ISO images, such as dd, Ventoy, GNOME's USB image writer or Etcher. Do not extract the ISO.
Boot from the USB drive
Select the USB drive in the computer's boot menu. Disable Secure Boot on UEFI systems, since the images do not have a compatible signature yet.
On the Install media
Open the installer
nvginstallThe expected result is the installer's start screen in the terminal. If the command is not found, make sure you booted from the Install image.
NVG Install
Basic offline installation
The system included on the media is copied to the disk. Networking is optional and lets you bring your Nostr identity. Before writing, the review step shows the chosen disk and the changes. The summary below groups the decisions; the number of screens depends on the media and on the recovered profile.
- 01
Start
Introduces the installer and the offline installation.
- 02
Network
Optional connection to recover Nostr identity data.
- 03
Identity
Optional Nostr key setup.
- 04
Disk
Disk selection and required space check.
- 05
Account
User, password, keyboard and time zone.
- 06
Review
Review of the changes before writing to disk.
- 07
Installation
Copies the system from the media to the disk.
Precautions
Disk, identity and completion
Disk erasure
The default installation erases the entire selected disk. Manual mode lets you use existing partitions. Check the disk and the changes on the review screen before confirming.
The Nostr key is optional
You can create a local account without a Nostr key. The installation can continue without a network or when the relay is unavailable.
Completion warnings
Failures in the final steps are recorded as warnings once the system has already been written. The first-boot assistant brings those pending items back up.