Get started with installing and upgrading OpenProject using [our Installation Guide starting point](https://www.openproject.org/open-source/download/).
Get started with installing and upgrading OpenProject using [our Installation Guide starting point](https://www.openproject.org/open-source/download/).
The guides for manual and Docker-based installations [are located here](./installing/README.md).
The guides for [manual](./installation/manual/README.md), [packaged](./installation/packaged/) and [Docker-based](./installation/docker/README.md) installations are provided.
## Upgrading
## Upgrading
The detailed upgrade instructions for our packaged installer are located on the [official website](https://www.openproject.org/download/upgrade-guides/).
The detailed upgrade instructions for our packaged installer are located on the [official website](https://www.openproject.org/download/upgrade-guides/).
The guides for manual and Docker-based installations [are located here](./upgrading/README.md).
The guides for [manual](./operations/upgrading/manual/upgrading.md), [packaged](./operations/upgrading/packaged/upgrading.md) and [Docker-based](./operations/upgrading/docker/upgrading.md) upgrading are provided.
## Operation
## Operation
* [Backup guide](./backup/README.md)
* Backup guides for [manual](./operations/backup/manual/backup.md), [packaged](./operations/backup/packaged/backup.md) and [Docker-based](./operations/backup/docker/backup.md) installations
* [Alter configuration of OpenProject](./configuration/README.md)
* [Alter configuration of OpenProject](./configuration/configuration.md)
* [Manual repository integration for Git and Subversion](./repositories/README.md)
* [Manual repository integration for Git and Subversion](./repositories/README.md)
@ -30,7 +30,7 @@ Please see our [User Guide pages](https://www.openproject.org/help/user-guides/)
## Development
## Development
* [Quick Start for developers](./development/quick-start.md)
* [Quick Start for developers](./development/quick-start.md)
* [Full development environment for developers](./development/setting-up-development-environment.md)
* [Full development environment for developers on Ubuntu](./development/development-environment-ubuntu.md) and [Mac OS X](./development/development-environment-osx.md)
Starting with 5.0, OpenProject directly manages your repositories. To
Starting with 5.0, OpenProject directly manages your repositories. To
use this feature you have to configure OpenProject as shown
use this feature you have to configure OpenProject as shown
[here](./repository-integration.md).
[here](../../repositories/README.md).
Add this line into `configuration.yml` file at the end of the file for
Add this line into `configuration.yml` file at the end of the file for
a better performance of OpenProject:
a better performance of OpenProject:
@ -437,15 +437,15 @@ We do however support an integration with the Apache webserver to create and ser
OpenProject ships with support for so-called *managed* repositories, which can be created and maintained directly within OpenProject and are linked to a single project.
OpenProject ships with support for so-called *managed* repositories, which can be created and maintained directly within OpenProject and are linked to a single project.
The complete guide for the integration of Subversion and Git repositories can be found in the [repository integration guide](repository-integration.md).
The complete guide for the integration of Subversion and Git repositories can be found in the [repository integration guide](../../repositories/README.md).
## Follow-Ups
## Follow-Ups
Your OpenProject installation is ready to run. However, there are some things to consider:
Your OpenProject installation is ready to run. However, there are some things to consider:
* Regularly backup your OpenProject installation. See the [backup guide](backup-guide.md) for details.
* Regularly backup your OpenProject installation. See the [backup guide](../../operations/backup/manual/backup.md) for details.
* Serve OpenProject via https
* Serve OpenProject via https
* Watch for OpenProject updates. We advise to always run the latest stable version of OpenProject (especially for security updates). Information on how to perform an update can been found in the [upgrade guide](upgrade-guide.md). You can find out about new OpenProject releases in our [news](https://community.openproject.org/projects/openproject/news), or on [twitter](https://twitter.com/openproject).
* Watch for OpenProject updates. We advise to always run the latest stable version of OpenProject (especially for security updates). Information on how to perform an update can been found in the [upgrade guide](../../operations/upgrading/manual/upgrading.md). You can find out about new OpenProject releases in our [news](https://community.openproject.org/projects/openproject/news), or on [twitter](https://twitter.com/openproject).
@ -68,7 +68,7 @@ Part of the managed repositories functionality was previously provided with repo
Reposman periodically checked for new projects and automatically created a repository of a given type.
Reposman periodically checked for new projects and automatically created a repository of a given type.
It never deleted repositories on the filesystem when their associated project was removed in OpenProject.
It never deleted repositories on the filesystem when their associated project was removed in OpenProject.
This script has been integrated into OpenProject and extended. If you previously used reposman, please see the [upgrade guide to 5.0](./upgrade-guide.md) for further guidance on how to migrate to managed repositories.
This script has been integrated into OpenProject and extended. If you previously used reposman, please see the [upgrade guide to 5.0](../operations/upgrading) for further guidance on how to migrate to managed repositories.