Table of Contents

Horde 6 Installation Instruction (Draft)

Horde 6 (unreleased) uses the composer package manager. https://getcomposer.org/doc/00-intro.md A lot of details have changed compared to previous versions.
Before running this code in production, please ensure you are familiar with the procedures

Linux Server: Installation from Scratch

This section is about an end user installation for testing or running in production

Prerequisites

* SQL Database Setup
* Web Server Setup
* PHP Version and Extensions
* Composer
* git - optional, recommended
* IMAP and SMTP Server -optional, needed for Webmail and other mail related services

Installation Steps

This section goes through an installation step by step. You will first setup Horde with users stored into a SQL database, then add groupware applications with their default settings and finally setup Web Mail and Filters.
See "Recovering" for more concise, automation-friendly instructions.

* Get A Root Project
* Install the Horde Base System, connect to database, inject initial admin user

Install Horde Applications

Kronolith Calendar, Nag Tasks, Mnemo Notes, Passwd Password, Turba Contacts, content/timeobjects
IMP Webmail, Ingo Mail Filter Manager
Gollem File Manager
Wicked WIKI - TBD?
Hermes Time Tracking - TBD?
Whups Ticket System - TBD?
Ansel Photo Gallery App - TBD?
Sesha Inventory App - TBD?
Development Tools: Components, Chora Repo Viewer, ?
Installing a Third Party application for the Horde 6 Framework?

Removing a Horde Application

How to remove an app

Upgrading a Horde 6 system after installation

How to upgrade a single app or the whole deployment

Backup a Horde Installation

How to backup a horde environment

Recovering from Backup

How to recover from a backup

Developer Install

This section is for developers. If you don't intend to work with git and run the very latest, untested code, then this is not for you.

There is a developer container setup if that's your thing. https://github.com/horde/horde-support/tree/feat/containers. Don't run this for anything but testing.

For a developer setup right on your machine, provided you already have a mail server, a database etc

1) Get the latest build of horde-components.phar from https://github.com/horde/components/releases
2) Export a github token to your shell:
export GITHUB_TOKEN=ghp_...
export HORDE_GIT_DIR=/srv/git/
export HORDE_INSTALL_DIR=/var/www/horde-dev
3) Run horde-components github-clone-org
4) Run horde-components install
5) cd /var/www/horde-dev
6) composer install
7) cp /var/www/horde-dev/vendor/horde/horde/config/conf.php.dist /var/www/horde-dev/var/config/horde
8) composer horde:reconfigure
9) Configure your webserver and/or php-fpm. The /web dir is your webroot. /web/horde/ is your horde base app.
10) Amend your configuration until you have your database configuration. Then run /var/www/horde-dev/vendor/bin/horde-db-migrate.
11) Then setup authentication. If you use SQL authentication you can inject a user from the command line.
12) Install more horde apps:
composer require horde/nag
composer require horde/mnemo
composer require horde/kronolith
composer require horde/passwd

Run the migration again:
/var/www/horde-dev/vendor/bin/horde-db-migrate

Put the config files in /var/www/horde-dev/var/config/$app
Run composer horde:reconfigure to link the config files.

To update your installation to the latest upstream changes run again horde-components.phar github-clone-org

Ready to run docker groupware setup

Windows: Installation from scratch

How to install on Windows 10 or 11?

Upgrading from Horde 5 PEAR or Linux Distribution

Upgrade from official Horde 5 releases

Upgrading from Horde 5 git-tools installation

From git-tools?

Upgrading from Horde 4 or older

TBD

Developer specific workflows

Checkout a single library and setup for development?
Upgrade a single application and dependencies to development versions?
Release an application version?

Known issues

Known issues and proposed fixes for current alpha version

---

Back to the Development Documentation?