Updating ArozOS

Backup Important Files

Before any update of ArozOS, backup the following files. You can find this with these relative path with the ArozOS root. (Default: /home/pi/arozos/)

system/ao.db (System Database)
system/storage.json (Storage config)
system/bridge.json (Bridge configs)
system/*.json (Group Storage configs)
./files (User files, if leave -root as default)

Update Instructions

Update ArozOS from image / pre-build binary

If you are using a version of ArozOS that is setup with downloading binary executables, (i.e. Dowloading the exe from the Release page), follow the steps below to update your ArozOS

Download the new binary and web.tar.gz file. Unzip the web.tar.gz to a temporary location.
Backup all your important data and configurations.
Replace the old binary executable, web and system folder with your newly downloaded release
Start up the ArozOS binary to complete the update

Update ArozOS Raspberry Pi image

If you are using the offical Raspberry Pi image for ArozOS, you can update the ArozOS by connecting to the terminal of the pi via SSH.

Connect your pi using SSH.
1. If you are on Windows, download and install Putty and connect to your Pi using your pi IP (e.g. 192.168.0.100)
2. If you are using MacOS, open Terminal App and enter ssh pi@{your_rasberry_pi_IP} (e.g. ssh [email protected])
Backup your important files.
Execute the update.sh
```
cd ~/
./update.sh
```

Restart the ArozOS via systemd

sudo systemctl restart arozos
   
#For older version of ArozOS
sudo systemctl restart aroz-online

Update ArozOS from source

If you are installing ArozOS from source, you can easily update via git command.

Backup all your important files
Pull the new source from Github
1. If you have modified the code, you can pull and merge your change into your system
```
git pull
```
2. If you have screwed up your source code, you can hard reset your whole source code to the offical repo
```
git fetch --all
git reset --hard origin/master
```
Build the new ArozOS from source
```
go mod tidy
go build
```
Restart your ArozOS via systemd
```
sudo systemctl restart arozos
```

Frequently Asked Questions

Why I cannot connect to my server after update?

If you have modified start.sh / start.bat, you might want to check if the start.sh is being modified in the update process. If no, check if the new ArozOS is started by using the following a command

sudo systemctl status arozos

to check if the service is running or not. If it is not working, try restart it using sudo systemctl restart arozos or seek help at our Telegram group.

Why my storage pool settings are gone after update?

This is normal if you are replacing the ArozOS using manual overwrite / hard reset method. Simply restore the system/storage/*.json and system/storage.json files and restart ArozOS to restore the previous settings.

Why I cannot discover my device in Network Neighbourhood after the update?

Network Neighbourhood require SSDP broadcast technology. After the old service stopped, it will take some time for the SSDP broadcasted information to timeout and re-discovered from the network. It usually takes a few hours for all computers in the Local Area Network to the next discovery.

In the mean time, you can use direct IP method to connect to your host by using IP Scanner / visit your router's DHCP client list.

How to update ArozOS.md 3.5 KB History Raw