The website https://tails.boum.org/ is built using Ikiwiki from source code that is available in our main Git repository, along with the rest of the Tails code.

You can build a local copy of the website on your computer. Building the website produces a set a HTML pages stored on your system that you can open in your usual web browser even while working offline. Doing so is useful for documentation writers and translators to see how their changes will apply on the website.

Build the website in Linux

  1. Update the list of available packages:

    sudo apt update
    
  2. Install the required packages:

    sudo apt install libyaml-perl libyaml-libyaml-perl po4a \
     perlmagick libyaml-syck-perl ikiwiki
    

    You need to install ikiwiki version 3.20170111~bpo8+1 or newer. In Debian this version is currently available in Stretch and jessie-backports.

  3. Clone our main Git repository:

    git clone https://git-tails.immerda.ch/tails
    

    The source code of the website is located in the wiki/src/ folder.

  4. Build the website:

    cd tails
    ./build-website
    

    To accelerate the build, you can disable some languages by editing the po_slave_languages parameter in the file ikiwiki.setup.

  5. You can now browse your local copy of the website in the following folder:

    config/chroot_local-includes/usr/share/doc/tails/website/

Build the website in Tails

  1. Create and configure a persistent volume and activate the following features:

    • Personal Data
    • APT Packages
    • APT Lists
  2. Restart Tails, enable the persistence, and set up an administration password.

  3. Update the list of available packages:

    sudo apt update
    
  4. Install the required packages:

    sudo apt install libyaml-perl libyaml-libyaml-perl po4a \
     perlmagick libyaml-syck-perl ikiwiki
    
  5. Clone our main Git repository in the Persistent folder:

    cd ~/Persistent/
    git clone https://git-tails.immerda.ch/tails
    

    The source code of the website is located in the wiki/src/ folder.

  6. Build the website:

    cd tails
    ./build-website --set destdir="/home/amnesia/Persistent/Tor Browser/tails" "$@"
    

    To accelerate the build, you can disable some languages by editing the po_slave_languages parameter in the file ikiwiki.setup.

  7. You can now visit the following link in Tor Browser to browse your local copy of the website:

    file:///home/amnesia/Persistent/Tor Browser/tails/index.en.html