Skip to main content

​
Overview

The Centinela desktop application (Mas Agua) is distributed as native installers for Windows, macOS, and Linux. Choose the appropriate installer for your operating system and follow the platform-specific instructions below.
All installers are available from the GitHub Releases page. Always download the latest version for the best experience and security updates.

​
Downloading the Installer

1

Navigate to Releases

Go to the Releases page on GitHub.
2

Select Your Platform

Download the appropriate installer for your operating system:
  • Windows: Mas-Agua_[version]_x64_en-US.msi
  • macOS: Mas-Agua_[version]_universal.dmg
  • Linux (Debian/Ubuntu): mas-agua_[version]_amd64.deb
  • Linux (Fedora/RHEL): mas-agua-[version]-1.x86_64.rpm
  • Linux (Universal): mas-agua_[version]_amd64.AppImage
3

Verify the Download

Check that the file downloaded completely and matches the expected file size shown on the releases page.
Current stable version: 1.0.4

​
Windows Installation

The Windows version uses the MSI (Microsoft Installer) format for easy installation and removal.
1

Run the Installer

Double-click the downloaded .msi file:
Mas-Agua_1.0.4_x64_en-US.msi
2

User Account Control

If prompted by Windows User Account Control (UAC), click Yes to allow the installer to make changes to your device.
3

Installation Wizard

Follow the installation wizard:
  • Accept the license agreement
  • Choose installation location (default: C:\Program Files\Mas Agua)
  • Select whether to create a desktop shortcut
  • Click Install
4

Complete Installation

Wait for the installation to complete, then click Finish. The application will launch automatically if you selected that option.

​
Windows Firewall

If Windows Firewall prompts you to allow network access:
Allow both Private and Public networks to ensure the application can communicate with your water treatment monitoring infrastructure.

​
Command-Line Installation

For automated deployment, you can install silently using: 
msiexec /i "Mas-Agua_1.0.4_x64_en-US.msi" /quiet /norestart

​
Uninstallation

To uninstall on Windows:
  1. Open Settings > Apps > Installed apps
  2. Find Mas Agua in the list
  3. Click the three dots menu and select Uninstall

​
macOS Installation

The macOS version is distributed as a DMG (Disk Image) containing the application bundle.
1

Open the DMG

Double-click the downloaded .dmg file:
Mas-Agua_1.0.4_universal.dmg
2

Drag to Applications

In the window that opens, drag the Mas Agua icon to the Applications folder.
3

Eject the DMG

After copying is complete, eject the disk image by right-clicking it in Finder and selecting Eject.
4

First Launch

Open Applications folder and double-click Mas Agua to launch the application.

​
Gatekeeper Security

On first launch, macOS Gatekeeper may block the application:
  1. Click Cancel when the warning appears
  2. Open System Settings > Privacy & Security
  3. Scroll to the Security section
  4. Click Open Anyway next to the Mas Agua warning
  5. Click Open in the confirmation dialog
The universal DMG includes binaries for both Intel and Apple Silicon Macs, ensuring optimal performance on all Mac hardware.

​
Uninstallation

To uninstall on macOS:
  1. Open the Applications folder
  2. Drag Mas Agua to the Trash
  3. Empty the Trash

​
Linux Installation

Linux users have three installation options: DEB (Debian/Ubuntu), RPM (Fedora/RHEL), or AppImage (universal).

​
Debian/Ubuntu (.deb)

1

Install via GUI

Double-click the .deb file and click Install in the software center.
2

Or Install via Terminal

sudo dpkg -i mas-agua_1.0.4_amd64.deb
sudo apt-get install -f  # Install dependencies if needed
3

Launch the Application

Launch from your applications menu or run:
mas-agua

​
Fedora/RHEL (.rpm)

1

Install via DNF

sudo dnf install mas-agua-1.0.4-1.x86_64.rpm
2

Or Install via YUM

For older systems:
sudo yum install mas-agua-1.0.4-1.x86_64.rpm
3

Launch the Application

Launch from your applications menu or run:
mas-agua

​
AppImage (Universal)

AppImages are self-contained executables that work on most Linux distributions without installation.
1

Make Executable

chmod +x mas-agua_1.0.4_amd64.AppImage
2

Run the Application

./mas-agua_1.0.4_amd64.AppImage
3

Optional: Integrate with System

For desktop integration, install AppImageLauncher:
# Ubuntu/Debian
sudo apt install appimagelauncher

# Fedora
sudo dnf install appimagelauncher
Then double-click the AppImage and choose Integrate and run.
AppImages require FUSE to run. Most modern Linux distributions include it by default. If you encounter issues, install FUSE:
# Ubuntu/Debian
sudo apt install fuse libfuse2

# Fedora
sudo dnf install fuse fuse-libs

​
Linux Dependencies

The application requires WebKit2GTK. Install if missing: 
sudo apt install webkit2gtk-4.0 libappindicator3-1

​
Uninstallation

sudo apt remove mas-agua

​
Post-Installation

After installing the application on any platform:

​
First Launch Configuration

1

Launch Application

Open Mas Agua from your applications menu or desktop shortcut.
2

Configure Server Connection

On first launch, you’ll be prompted to configure the connection to your Centinela backend server. Enter your server URL and credentials.
3

Verify Installation

Check the application version by navigating to Help > About. It should display version 1.0.4.

​
Auto-Update Configuration

The application includes built-in auto-update functionality:
Updates are automatically checked from the GitHub releases endpoint. You’ll be notified when a new version is available. See the Updates guide for more details.

​
Troubleshooting

​
Application Won’t Launch

Windows
  • Ensure you’re running Windows 10 version 1903 or later
  • Try running as administrator
  • Check Windows Event Viewer for error messages
macOS
  • Verify you’ve allowed the app in Security & Privacy settings
  • Try removing quarantine attribute: xattr -d com.apple.quarantine /Applications/Mas\ Agua.app
Linux
  • Verify WebKit2GTK is installed
  • Check console output for missing dependencies
  • Ensure you have execute permissions on the binary

​
Connection Issues

If the application can’t connect to your monitoring server:
  1. Verify the server URL is correct
  2. Check firewall settings allow outbound connections
  3. Ensure your network allows WebSocket connections
  4. Verify SSL certificates if using HTTPS

​
Getting Help

For additional support:
  • Check the application logs in:
    • Windows: %APPDATA%\com.masagua.desktop\logs
    • macOS: ~/Library/Application Support/com.masagua.desktop/logs
    • Linux: ~/.local/share/com.masagua.desktop/logs
  • Report issues on the GitHub repository

​
Next Steps

Now that you’ve installed the desktop application: