Steps to Install Osdag (v2026.04.0.0) [Release 2026-April-06]

---

System Requirements

64-bit architecture; ≥4 GB RAM and ≥3.5 GB free storage (recommended).

For Windows and Linux, you may use these installers directly:

Windows 10 & 11 (64-bit)

• ⬇️ Installer Package 873 MB

Linux Distribution (64-bit)

Show Installation Steps ⬇️

For installing Osdag in Linux using the installer, follow these steps:

1. ⬇️ Click here to download the package , store it to a folder (usually Downloads), and open that folder.
2. Right-click on the file Osdag-2026.02.0.0-Linux-x86_64.sh and open it using Terminal, OR open a terminal and navigate to the folder.
3. Give execute permission to the installer:

   chmod +x Osdag-2026.02.0.0-Linux-x86_64.sh

4. Run the installer:

   ./Osdag-2026.02.0.0-Linux-x86_64.sh

5. The installer will start. Follow the on-screen instructions:
   • Choose installation directory (default is recommended)
   • Allow creation of desktop shortcut
   • Wait for installation to complete
6. After installation, Osdag can be launched from Applications menu → Osdag

Notes

1. If permission error occurs, run using sudo
2. If installer does not open, run using bash Osdag-2026.02.0.0-Linux-x86_64.sh
3. Ensure required libraries are installed if any error occurs
4. Refer to Section R2 in the uninstall section for the uninstallation command.

The Conda-based installation procedure for Osdag is valid across platforms, which include Windows and Linux distributions.

1. Install miniconda3 (docs.anaconda.com/miniconda/install) if not installed already. If it is already installed, please update to Miniconda3 v26.1.1-1. Any other installation giving access to the latest conda version (e.g. Anaconda, miniforge, etc.) is also OK.
2. Open the conda-enabled shell. (Instructions are available on the Miniconda3 installations page)
   1. a. For Windows: Open the Anaconda Command Prompt or Anaconda PowerShell Prompt. These should be available from the Start menu after installation.
   2. b. For Linux: Open the terminal.
3. Run this command:

   conda create -n osdag-env osdag::osdag -c conda-forge -c geompy

   This will create a new environment and install Osdag in it. It may take several minutes to get the prompt back.
4. To run Osdag, from the same shell, run these two commands:

   conda activate osdag-env

   osdag

5. This will open the Osdag application.
6. Attempt a sample problem to make sure everything is working.
7. To run Osdag in the future, follow Step 4. This will not require an internet connection.

---

Updating Osdag

Note: These instructions will be applicable only to prospective releases. For any previous version before v2026.02.0.0, these commands will not work.

U1.	Occasionally, update Osdag as new updates may have been added since the install. You should check the release notes of the updated version for any further instructions.
U2.	To update Osdag, run these two commands: conda activate osdag-env conda install python=3.12 conda update -c osdag -c geompy osdag
U3.	To open Osdag after updating, run this command (with osdag-env activated): osdag
U4.	To run Osdag in the future, follow Step 4 from the installation instructions. This will not require an internet connection.

Note: Updating Osdag installed through the installer is not available for v2026.02.0.0. Uninstall Osdag from your windows PC using the uninstallation instructions, and install again with the new installer. Uninstalling the previous version (v2026.02.0.0) is essential.

In Case of Issues

1. A. In case of issues during Steps 3 or 4, i.e. if Osdag is not installed or does not run, you could try to use the alternative mamba solver.

   A1.	To activate the environment, run: conda activate osdag-env
   A2.	Run this command to install mamba: conda install mamba
   A3.	Run this command to install Osdag through mamba: mamba install osdag::osdag -c conda-forge -c osdag

2. B. In case you already have an older version of miniconda3, update it to the latest version.

   B1.	Run this command to update miniconda3 to the latest version (v26.1.1-1): conda update conda
   B2.	Check if miniconda3 has been updated to the latest version conda --version
   B3.	This should show that it has been updated to v26.1.1-1 in the terminal. If updating does not work, uninstall miniconda3 and reinstall it (follow the installation instructions after uninstallation of the older version).

Minor crashes may happen in Linux systems. Refer to this webpage (https://github.com/osdag-admin/Osdag/issues) to explore known issues and their possible solutions. This version of Osdag is not compatible with macOS.

Uninstalling Osdag

R1. For uninstalling Osdag in Windows 10 and 11 when installed directly with the installer, follow these steps:

1. ‎ ‎ I. In the Start menu (or press Windows key), search for Osdag.
2. ‎ II. Osdag can be uninstalled by selecting the “Uninstall” button from the details on the left.
3. III. Consequently, Osdag can also be uninstalled from the control panel.
   1. ‎ i. In the Start menu (or press Windows key), search for “Uninstall a program”.
   2. ii. From the list of installed software, search for Osdag. A right click on Osdag will show the “Uninstall” button.

R2. For uninstalling Osdag in Linux when installed directly with the installer, follow these steps:

1. ‎ ‎ I. In the Start menu (or press Super key), search for Uninstall Osdag.
2. ‎ II. A terminal window will open with the prompt:

   Are you sure you want to uninstall Osdag? [y/N]:

3. III. Type y and press Enter to proceed with uninstallation.
4. IV. Wait for the process to complete. Osdag will be removed from your system.
5. ‎ V. (Optional) If any files remain, you may manually delete the installation folder.

R3. For uninstalling Osdag for conda-based installation:

1. ‎ ‎ I. Open the conda-enabled shell.
1. ‎ i. For Windows: Open the Anaconda Command Prompt or Anaconda PowerShell Prompt. These should be available from the start menu after installation.
2. ii. For Linux: Open the terminal.
2. ‎ II. Run this command:

   conda remove --name osdag-env --all

         This will delete the conda environment with all installed dependencies.
3. III. To uninstall miniconda3, refer to the instructions on their website: Miniconda Uninstallation Guide