[[toc]]

• 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

• ((Doc/Dev/H6/Installation/SQL|SQL Database Setup))
• ((Doc/Dev/H6/Installation/WebServer|Web Server Setup))
• ((Doc/Dev/H6/Installation/PHP|PHP Version and Extensions))
• ((Doc/Dev/H6/Installation/Composer|Composer))
• ((Doc/Dev/H6/Installation/git|git - optional, recommended))
• ((Doc/Dev/H6/Installation/Mail|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.

• ((Doc/Dev/H6/Installation/RootProject|Get A Root Project))
• ((Doc/Dev/H6/Installation/InstallBase|Install the Horde Base System, connect to database, inject initial admin user))

+++ Install Horde Applications

((Doc/Dev/H6/Installation/InstallAppsGroupware|Kronolith Calendar, Nag Tasks, Mnemo Notes, Passwd Password, Turba Contacts, content/timeobjects))
((Doc/Dev/H6/Installation/InstallAppsMail|IMP Webmail, Ingo Mail Filter Manager))
((Doc/Dev/H6/Installation/InstallAppsGollem|Gollem File Manager))
((Doc/Dev/H6/Installation/InstallAppsWicked|Wicked WIKI - TBD))
((Doc/Dev/H6/Installation/InstallAppsHermes|Hermes Time Tracking - TBD))
((Doc/Dev/H6/Installation/InstallAppsWhups|Whups Ticket System - TBD))
((Doc/Dev/H6/Installation/InstallAppsAnsel|Ansel Photo Gallery App - TBD))
((Doc/Dev/H6/Installation/InstallAppsSesha|Sesha Inventory App - TBD))
((Doc/Dev/H6/Installation/InstallAppsDev|Development Tools: Components, Chora Repo Viewer, ))
((Doc/Dev/H6/Installation/InstallThirdParty|Installing a Third Party application for the Horde 6 Framework))

+++ Removing a Horde Application

((Doc/Dev/H6/Installation/UninstallApps|How to remove an app))

+++ Upgrading a Horde 6 system after installation

((Doc/Dev/H6/Installation/UpgradeApps|How to upgrade a single app or the whole deployment))

+++ Backup a Horde Installation

((Doc/Dev/H6/Installation/BackupApps|How to backup a horde environment))

+++ Recovering from Backup

((Doc/Dev/H6/Installation/Recovery|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

((Doc/Dev/H6/Installation/Windows|How to install on Windows 10 or 11))

++ Upgrading from Horde 5 PEAR or Linux Distribution

((Doc/Dev/H6/Installation/UpgradeH5Release| Upgrade from official Horde 5 releases))

++ Upgrading from Horde 5 git-tools installation

((Doc/Dev/H6/Installation/UpgradeH5Git|From git-tools))

++ Upgrading from Horde 4 or older

TBD

++ Developer specific workflows

((Doc/Dev/H6/Developer/LibraryWorkflow|Checkout a single library and setup for development))
((Doc/Dev/H6/Developer/ApplicationWorkflow|Upgrade a single application and dependencies to development versions))
((Doc/Dev/H6/Developer/ReleaseWorkflow|Release an application version))

++ Known issues
((Doc/Dev/H6/Developer/KnownIssues|Known issues and proposed fixes for current alpha version))

---

Back to the ((Doc/Dev/|Development Documentation))