Installation guide

Install Ocuvia, step by step.

From a verified download to your first analysis. Every step keeps your security protections switched on.

Before you begin

Check the release notes of the build you download for its system, GPU and driver requirements.
Make sure you are allowed to install software on the computer you are using.
Download only from the download page, and keep your security software switched on throughout.

Linux

Release being prepared

01
Download the supported package
Get the Linux build from the download section, and use only the file listed there.
02
Verify its checksum
Compute the file's SHA-256 checksum and compare it with the value shown for that exact file.
03
Install or run it
Follow the requirements of the package format you downloaded. The installation guide covers each format.
04
Launch Ocuvia
Start Ocuvia from your applications menu, or from the file you saved, depending on the format.

By package format

Use the instructions for the format offered in the download section. Only formats that have actually been published are offered there. Replace file-name with the name of your file.

AppImage

Make the file executable, then run it.

$chmod +x file-name.AppImage

$./file-name.AppImage

Many distributions need the FUSE 2 library to run AppImages, for example the libfuse2 package on Ubuntu 22.04, or libfuse2t64 on Ubuntu 24.04 and later.

Debian package (.deb)

Install it with your package manager, which also installs the dependencies the package declares.

$sudo apt install ./file-name.deb

RPM package (.rpm)

Install it with your package manager on Fedora and related distributions.

$sudo dnf install ./file-name.rpm

Windows

Coming soon

There is no Windows build yet. These steps apply once a real, verified installer is published.

01
Download the verified installer
Get the Windows installer from the download section once a real build is published.
02
Verify the file and its publisher
Compare its SHA-256 checksum, and if the installer is signed, confirm Windows shows the expected publisher.
03
Run the installer
Follow the installer's own setup steps through to the end.
04
Launch Ocuvia
Open Ocuvia once setup has finished.

Checking the publisher

If the installer is digitally signed, the Windows permission prompt shows its verified publisher. You can also right-click the file, choose Properties, and open the Digital Signatures tab.

If the publisher is missing or unexpected, compare the checksum before going any further, and do not run a file you cannot verify.

If Windows shows a security warning, keep SmartScreen and your antivirus switched on. Treat the warning as a reason to stop and check the file, not as a step to skip.

Verify a download

Run the command for your system, replacing file-name with the name of the file you downloaded. The result must match the SHA-256 checksum shown for that file exactly. If it does not, delete the file and download it again.

Linux · Terminal

$sha256sum file-name

Windows · PowerShell

$Get-FileHash file-name -Algorithm SHA256

Troubleshooting

The checksum does not match: Delete the file and download it again from the download section. Never run a file whose checksum does not match the published value.
The AppImage does nothing when opened: Make sure the file is executable, and that your system has the FUSE 2 library described in the Linux section.
Analysis is slower than expected: Analysis speed depends on your hardware. Check the release notes of your build for its GPU and driver requirements.
Something else went wrong: Report it with your operating system, the Ocuvia version and the steps that lead to the problem. Never include identifiable patient images or data.

Read the frequently asked questions

Uninstalling

Remove Ocuvia the same way you installed it. An AppImage is removed by deleting the file. A .deb or .rpm package is removed with your package manager. On Windows, use Settings, then Apps, then Installed apps.

Back up any records you want to keep before you uninstall.