Setup checklistProfile settings
Desktop Agent — Install & Permissions

Installing the Anastasis desktop agent

Install the desktop tracker on macOS, Windows, or Linux so approved work can create time and screenshot evidence.

Contractors · 6 min read · updated 2026-09-30

¿Prefieres español? Lee esta guía en español.

The Anastasis desktop agent records billable time and captures screenshot evidence while you are clocked in on an active engagement. You only need to install it once per computer. It is available for Windows, macOS (Apple Silicon and Intel), and Linux (AppImage and .deb).

Install the app

From the contractor portal dashboard, find the Anastasis Desktop card. It offers the download for your operating system, with the other platforms one click away.
Download and install the app, then open it.
Link the app to your profile: click Sign in with your browser in the app, then Connect this computer in the portal tab that opens. Nothing to type. If that does not work, see linking your computer for the pairing-code fallback.
Review and accept the consent notice in the app. Tracking cannot start before you do.
When a shift starts, clock in from the app. Screenshots are captured only while you are clocked in.

Platform notes

  • macOS: the very first launch needs right-click the app → Open → Open — macOS asks for that confirmation for tools handed out directly rather than through the App Store. (Double-clicking shows a warning without an open option.) You must also grant Screen Recording permission in System Settings → Privacy & Security before tracking can start. Pick the download that matches your Mac: Apple Silicon (M1/M2/M3/M4) or Intel.
  • Windows: SmartScreen may ask for an extra confirmation the first time, as it does for tools handed out directly rather than through the Microsoft Store. Choose More info → Run anyway. Confirm you downloaded the app from your Anastasis portal before continuing.
  • Windows with Smart App Control: if instead you see “Smart App Control blocked an app that may be unsafe”, there is no “run anyway” option — that feature blocks any app it cannot verify. First try right-clicking the downloaded file → Properties → tick Unblock → Apply, then open it again. If it is still blocked, the app can only be installed by turning the feature off: Windows Security → App & browser control → Smart App Control settings → Off. Windows does not let you switch it back on afterwards without reinstalling Windows, so it is your call — tell your Anastasis contact if you would rather not, and we will sort out another option with you.
  • Linux: the AppImage runs anywhere after chmod +x; the .deb installs system-wide on Debian/Ubuntu. Screenshot capture depends on the desktop session: on Wayland, install xdg-desktop-portal and accept the portal prompt; on X11 it works out of the box.

Updates

On Windows and the Linux AppImage, the app checks for updates when it starts and every few hours after that. When one is available it shows a prompt: choose Update now, wait for the download, then Restart and update. Nothing installs until you accept it. Closing the window only hides the app to the tray, so if you were told to update and see no prompt, right-click the tray icon, choose Quit, and open the app again. On macOS and the Linux .deb, the app notifies you when a new version is available and links you back to the portal to download it.

En español

La app de escritorio de Anastasis registra tu tiempo facturable y toma capturas de pantalla como evidencia solo mientras tienes una jornada activa. Se instala una vez por computadora. Está disponible para Windows, macOS (Apple Silicon e Intel, macOS 12 o más reciente) y Linux (AppImage y .deb).

Instalar la app

En el panel del portal de contratista, busca la tarjeta Anastasis Desktop. Ahí está la descarga para tu sistema operativo.
Descarga e instala la app, y ábrela.
Vincula la app con tu perfil: en la app pulsa Iniciar sesión con el navegador y, en la pestaña del portal que se abre, pulsa Connect this computer. Si no funciona, consulta vincular tu computadora para usar un código.
Lee y acepta el aviso de privacidad (Aceptar y continuar). El monitoreo no puede empezar antes.
Cuando empiece tu jornada, pulsa Entrar. Las capturas solo se toman mientras estás dentro de la jornada.

Notas por sistema

  • Windows — Edge o SmartScreen: la app se entrega directamente, no desde la Microsoft Store, así que Windows pide una confirmación extra la primera vez. En Edge elige Conservar → Conservar de todas formas; en SmartScreen, Más información → Ejecutar de todas formas. Confirma antes que la descargaste desde tu portal de Anastasis.
  • Windows con Control inteligente de aplicaciones (Smart App Control): si ves “Control inteligente de aplicaciones bloqueó una aplicación que puede no ser segura”, no hay opción de “ejecutar de todas formas”. Primero haz clic derecho en el archivo descargado → Propiedades → marca Desbloquear → Aplicar, y ábrelo de nuevo. Si sigue bloqueado, la única forma es desactivar la función en Seguridad de Windows → Control de aplicaciones y navegador → Configuración de Control inteligente de aplicaciones → Desactivado. Windows no permite volver a activarla sin reinstalar Windows, así que la decisión es tuya: si prefieres no hacerlo, avisa a tu contacto de Anastasis y buscamos otra opción contigo.
  • macOS: la primera vez, haz clic derecho en la app → Abrir → Abrir (con doble clic solo aparece una advertencia). También debes permitir la Grabación de pantalla; consulta el permiso de pantalla.
  • Linux: la AppImage funciona en cualquier distribución tras chmod +x; el .deb se instala en Debian/Ubuntu. En Wayland instala xdg-desktop-portal y acepta el aviso para compartir pantalla.

Actualizaciones

En Windows y en la AppImage, la app busca actualizaciones al abrirse. Cuando hay una, aparece Actualización disponible: pulsa OK, actualizar, espera la descarga y luego Reiniciar y actualizar ahora. Nada se instala sin tu permiso. Cerrar la ventana solo la oculta en la bandeja del sistema; si te pidieron actualizar y no ves el aviso, haz clic derecho en el icono de la bandeja, elige Salir de la app (en versiones nuevas: Cerrar Anastasis Desktop) y vuelve a abrirla. En macOS y en el .deb, la app te avisa y te lleva al portal para descargar la nueva versión.

Related
Still stuck?
Ask us here and a real person answers. We’ll notify you when they do.
Contact support