Skip to content

Installation

Youssef Fathy edited this page Nov 12, 2025 · 3 revisions

Supported Platforms

Distro Install Method Status
Debian / Ubuntu .deb package ✅ Supported
Fedora / RHEL .rpm package ✅ Supported
Alpine .apk package ✅ Supported
Arch Linux AUR ✅ Supported
Nix Nix flake ⚠️ Manual setup
Others Generic tarball ✅ Supported

Quick Installation

You can install the latest release of go-pray with a single command:

curl -fsSLo - https://github.com/0xzer0x/go-pray/raw/refs/heads/main/install.sh | bash

This will install the appropriate package for the your detected distro. In case none of the supported distros were detected, the script will fallback to downloading the generic tarball method and will install go-pray to ./bin.

Customized Installation

Warning

Specifying a custom installation version is not supported on Arch Linux.

You can pin the installation to a specific version using the INSTALL_VERSION variable:

curl -sLo - https://github.com/0xzer0x/go-pray/raw/refs/heads/main/install.sh \
| env INSTALL_VERSION=0.1.3 bash

Nix

If you are using Nix, it is recommended to use the provided Flake.

If you're using Nix only, use the following command to add the package to your user profile:

nix profile add github:0xzer0x/go-pray

NixOS

Warning

For this method to work, your system configuration must be managed through Flakes.

Add the following to your system Flake inputs:

{
  # description = ...;
  inputs = {
    go-pray = {
      url = "github:0xzer0x/go-pray";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, go-pray, ... }@inputs: {
    # NOTE: Change yourhostname to your actual hostname
    nixosConfigurations.yourhostname = let system = "x86_64-linux";
      in nixpkgs.lib.nixosSystem {
      inherit system;
      modules = [
        ./configuration.nix
        ./hardware-confiugration.nix
        {
          # NOTE: Replace yourusername with actual username
          users.users.yourusername.packages = [
            go-pray.packages.${system}.default
          ];
        }
      ];
    };
  };
}

Home Manager Module

If your are already using Home Manager for managing your dotfiles, you can use the provided module for configuring go-pray:

# NOTE: home.nix
{
  imports = [
    inputs.go-pray.homeManagerModules.default
  ];

  # NOTE: Configures the go-pray daemon for prayer times desktop notifications
  services.go-pray = {
    enable = true;

    settings = {
      language = "en";
      calculation.method = "MWL";
      timezone = "Europe/London";
      location = {
        lat = 51.5176;
        long = -0.1612;
      };
      notification = {
        icon = "xclock";
        title = "Prayer Time";
        body = "Time for {{ .CalendarName }} prayer 🕌";
      };
    };
  };
}

Clone this wiki locally