Update viam-server
Channels
There are two main channels for updates. If you download a file for one of them, its self-update function will only look for updates from that particular channel. That is to say, “latest” will get a lot of updates, and “stable” will get them less frequently.
Latest
This is updated on every merge to the main branch of the codebase from which viam-server is built.
Stable
Updates will be far less frequent.
Update Methods
Manual / Service-based
These app images have a built in self-update feature. To update manually, just run the file with “–aix-update” as the only argument. For example:
sudo viam-server --aix-update
When installed as a system service, this will be run automatically each time the service is started.
Disable Service-based Updates
If you want to DISABLE automatic updates from the service file, just comment out the following line in /etc/systemd/system/viam-server.service with a pound sign (#) so that it looks like this:
# ExecStartPre=-/usr/local/bin/viam-server --aix-update
Fallback (Re-download)
Lastly, if all else fails, or you ever encounter any issues, you can simply just replace the file (usually /usr/local/bin/viam-server) with a newly downloaded copy.
There is typically no need to reinstall the system service (unless the new version includes an update to the service file), but there is no harm in doing so either.
You can upgrade to the latest stable version of viam-server using Homebrew.
brew upgrade viam-server
To upgrade to the absolute latest version of viam-server run this command:
brew upgrade viam-server --HEAD
There is not a way to automatically update viam-server on Mac, so we recommend running brew upgrade viam-server on a regular basis.
Have questions, or want to meet other people working on robots? Join our Community Discord.