OpenProject is the leading open source project management software.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openproject/docs/installation-and-operations/operation/faq/README.md

60 lines
3.1 KiB

---
sidebar_navigation:
title: FAQ
priority: 4
description: Frequently asked questions regarding operation and upgrading of OpenProject
robots: index, follow
keywords: operation FAQ, upgrading, database
---
# Frequently asked questions (FAQ) for Operation
## OpenProject says it's the newest version, although I know there's been a major release (e.g. 11.0). What's the problem? Why can't I upgrade?
Please note the steps that have been outlined in the blue box at the top [here](../upgrading). It's important to change the branch for this.
We implemented this to prevent users from upgrading to a major release (which could be not backwards compatible) by mistake.
Expanding documentation (#9091) * changed screenshots for projects chapter * changed screenshots in gantt chart chapter * moved "aggregation by project" from work packages to Gantt chart chapter * changed some links * move reference to Excel sync out of Gantt chart chapter * small changes * add initial setup section for administrators to documentation Idea and main content from @ivangriggs Co-Authored-By: ivangriggs <77022874+ivangriggs@users.noreply.github.com> * smaller improvements to docs * improve documentation of manual and automatic scheduling mode * small improvements in docs * small changes * adding section for search options in OpenProject * move section about hourly rate defintion to system admin guide * formatting changes * explaining assignee filter options * change section header to make it detectable when searching for "projects overview" * clean up table of contents, make titles consistent, remove excessive space characters, etc. * update screenshots * changes to project overview docs * add screenshot for search bar * make info about aggregation of changes in activity and notifications easier detectable * small improvements * add info about non member and anonymous role * changes/additions * small changes * add additional options to access context menu * add sum feature for work package list to docs and change screenshot * add/improve info about email notifications * link fixes (necessary due to structural changes in documentation) * working in review comments * changes for time tracking activities * change screen shots for wiki - more functions section * change screenshots and improve description for meetings * improve detectability of mention feature * move FAQ in authentication * add how to reset password * improve explanation on how to un-archive projects * mention Mattermost integration * small correction
4 years ago
## Will my data be lost when I upgrade OpenProject?
We strongly recommend a [backup](../backing-up) of your data before updating. Your data won't be lost in the regular update process, though.
## I lost access to my admin account, how do I reset my password?
You can reset your admin account through the Rails console. [Please see this separate page on how to start the console](../control/).
Assuming you have started the rails console, perform these steps:
```ruby
# Find the admin user
user = User.find_by! login: 'admin'
# Ensure the user is set to active
user.activate
4 years ago
# Reset any failed login attempts
user.failed_login_count = 0
# Update the password
user.password = user.password_confirmation = "YOUR NEW SAFE PASSWORD 1234!"
# Save the resource, observe if any errors are returned here
user.save!
```
Afterwards, you can navigate to your OpenProject instance and login with `admin` and your chosen password again.
## Do you provide different release channels?
Yes! We release OpenProject in separate release channels that you can try out. For production environments, **always** use the `stable/MAJOR` (e.g., stable/9) package source that will receive stable and release updates. Every major upgrade will result in a source switch (from `stable/9` to `stable/10` for example).
A closer look at the available branches:
4 years ago
* [stable/11](https://packager.io/gh/opf/openproject/refs/stable/10): Latest stable releases, starting with 11.0.0 until the last minor and patch releases of 11.X.Y are released, this will receive updates.
* [release/11.0](https://packager.io/gh/opf/openproject/refs/release/10.0): Regular (usually daily) release builds for the current next patch release (or for the first release in this version, such as 11.0.0). This will contain early bugfixes before they are being release into stable. **Do not use in production**. But, for upgrading to the next major version, this can be regarded as a _release candidate channel_ that you can use to test your upgrade on a copy of your production environment.
* [dev](https://packager.io/gh/opf/openproject/refs/dev): Daily builds of the current development build of OpenProject. While we try to keep this operable, this may result in broken code and/or migrations from time to time. Use when you're interested what the next release of OpenProject will look like. **Do not use in production!**
## How to backup and restore my OpenProject installation?
Please refer to the [backup documentation](../backing-up) for the packaged installation.