diff --git a/docs/faq.md b/docs/faq.md index 7dd468c7..267b6c0b 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -260,11 +260,23 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht * Do the same in `/etc/fstab` for the `/boot` partition. * Comment `tmpfs` lines in `/etc/fstab` for `/var/lib` and `/var/log`. !!! danger "But again: DON'T DO THIS" + +??? question "How to set the date, time and timezone from command line?" + * Become root with the command `su -` or `sudo -s`. + * Enable read/write with the command `rw`. + * Find your timezone string e.g. `timedatectl list-timezones` or `timedatectl list-timezones | grep -i australia`. + * Set the timezone with `timedatectl set-timezone ` e.g. `timedatectl set-timezone Australia/Victoria`. + * Stop the time syncing service with `systemctl stop systemd-timesyncd` as this will prevent the next step if running. + * Set the time and date with `timedatectl set-time 'YYYY-MM-DD HH:MM:SS'` e.g. `timedatectl set-time '2023-02-26 14:50:10'`. + * If you have hardware clock e.g. V3 & V4 HAT, update it with `hwclock --systohc` , then check it with `hwclock --show`. + * Switch filesystem to RO-mode with the command `ro`. + ??? question "How do I install or remove packages in PiKVM OS?" PiKVM OS is based on Arch Linux ARM and uses the [pacman](https://wiki.archlinux.org/title/Pacman) package manager. + * Ensure the date is correct: `date`. Otherwise you may get the error `SSL certificate problem: certificate is not yet valid` * Switch filesystem to RW-mode: `rw`. * Find some packages (`emacs` for example): `pacman -Ss emacs`. * Install it, while keeping the system updated: `pacman -Syu emacs`. @@ -276,10 +288,14 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht ??? question "How do I update PiKVM with the latest software?" This is ONLY recommended if you need a feature, otherwise this should ONLY be done if you are physically at the device and can reflash the sd card as a means of recovery. PiKVM OS is based on Arch Linux ARM and is fully updated from the repository by a regular package manager. Connect to your PiKVM via ssh and run: - ``` + * Ensure the date is correct: `date`. Otherwise you may get the error `SSL certificate problem: certificate is not yet valid` + * Run the following + ``` + # date # rw # pacman -Syu - # reboot + # sync + # reboot # Allow 10 to 15 minutes for a response. ``` Pacman saves all installed packages in a compressed format so that you can roll back to the old version if something goes wrong. After you've updated and made sure everything works, (ONLY for older images, newer images has this partition expended and no longer has this issue) it makes sense to clear the package cache so that it doesn't take up space on the SD card: `rw; rm -rf /var/cache/pacman/pkg; ro`.