[[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))