# How to install the speedata Publisher on your system

There are three ways to install speedata Publisher:

1. Binary packages (The recommended way): Go to our download page and download the latest package for your operating system. You can unzip the file anywhere in the filesystem you want. You don't need root/administrator rights to use the Publisher this way.

2. APT repository: If you have root or sudo rights on Debian or Ubuntu GNU/Linux (or a similar system), you can install the .deb files we have prepared from our APT repository. This is very easy, just follow a few steps:

   1. Add the following file to `/etc/apt/sources.list.d/speedata.list` for the development version (unstable):

          deb https://software.speedata.de/download/devel stable main

      or for the main (stable) releases:

          deb https://software.speedata.de/download/public stable main

   2. Add our GPG key to the system to make sure you get the correct software:

          curl -O http://de.speedata.s3.amazonaws.com/gpgkey-speedata.txt
          sudo apt-key add gpgkey-speedata.txt

   3. Now you can run `sudo apt update` and `apt get install speedata-publisher` and have a working installation. You can find the documentation in `/usr/share/doc/speedata-publisher/index.html` which should open with `sp doc` on a desktop system.

3. Build from source: For developers interested in contributing to speedata Publisher, the program and documentation can be built directly from source in the git repository using rake, if you have the Go language version 1.5 or later installed. For example, on Debian or Ubuntu GNU/Linux, where Go is packaged as 'golang', you can use the commands:

    sudo apt install build-essential git rake golang
    git clone https://github.com/speedata/publisher.git
    cd publisher
    rake build
    rake doc

(Please note that the version of golang in Debian stable (jessie), version 1.3.3, is not recommended for building speedata Publisher. The current golang version 1.6.2 can be installed on this distribution with:

    sudo apt install -t jessie-backports golang

as long as the jessie-backports repository is enabled in the `/etc/apt/sources.list` file on your machine).

If you are building speedata Publisher from source, you will also need to install LuaTeX manually. The recommended way is to download a binary from https://download.speedata.de/extra/ and copy it into the bin/ directory of the Publisher. For example, to download and install LuajitTeX 0.79.1 on a Linux amd64 system, you could use the commands:

    wget https://download.speedata.de/extra/luatex_079-win-mac-linux.zip
    unzip luatex_079-win-mac-linux.zip
    cp luatex/linux/amd64/0_79_1/sdluatex bin

After installation, you can run `bin/sdluatex --version` to confirm the program version.

Version: 2.8.1 | Start page | Element reference | Other language: German