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