How to Install PmWiki on NixOS Latest

PmWiki is a free and open-source wiki software application which can be installed on NixOS Latest. This guide will take you through the steps to download and install PmWiki on NixOS Latest.

Requirements

• NixOS Latest Installed
• Superuser access

Steps

1. Update the package manager:

sudo nix-channel --update

2. Install Apache web server and PHP using the following command:

sudo nix-env -iA nixos.httpd nixos.php

3. Now, download the PmWiki package from the PmWiki official website using the following command:

curl -L https://www.pmwiki.org/pub/pmwiki/pmwiki-latest.tgz | tar zx

4. Move the extracted files to the Apache default location /var/www/html using the following commands:

sudo rm -rf /var/www/html/*
sudo mv pmwiki-*/pmwiki/* /var/www/html/

5. Run the following command to set the correct permissions:

sudo chown -R apache:apache /var/www/html/

6. Create a new VirtualHost configuration file to serve PmWiki. This file should be saved at /etc/nixos/pmwiki.nix. Open this file using your favorite text editor, and then copy and paste the following configuration:

{ config, pkgs, ... }:

{
  services.httpd = {
    enable = true;
    adminAddr = "you@example.com";
    virtualHosts."yourdomain.com" = {
      documentRoot = "/var/www/html";
      serverAliases = [ "yourdomain.com" ];
      locations."/pmwiki" = {
        root = "/var/www/html";
        directoryIndex = [ "pmwiki.php" ];
      };
      locations."/pub" = {
        root = "/var/www";
        directoryIndex = [ "pmwiki.php" ];
      };
    };
  };
}

Note: Replace the "yourdomain.com" and "you@example.com" placeholders with your respective domain and email.

7. Save and close the file, then run the following command to update NixOS configuration:

sudo nixos-rebuild switch

8. Finally, start the Apache web server with the following command:

sudo systemctl start httpd

9. Open up your web browser, and browse to http://yourdomain.com/pmwiki. You should now be able to see the PmWiki installation page. Follow the prompts to complete the installation process.

Congratulations! You have successfully installed PmWiki on NixOS Latest.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!