This document is a guide to getting up and running with Fedora as quickly as possible.

Out of the box

If you are looking for scripted deployments, please take a look at Fedora's deployment tooling.

• Java 21

  java -version
  openjdk version "21.0.9" 2025-10-21 LTS
  OpenJDK Runtime Environment (Red_Hat-21.0.9.0.10-1) (build 21.0.9+10-LTS)
  OpenJDK 64-Bit Server VM (Red_Hat-21.0.9.0.10-1) (build 21.0.9+10-LTS, mixed mode, sharing)
  

• Servlet 6.0 container such as:
  
  • Tomcat 10+
  • Jetty 12.x
• A case-sensitive filesystem. Fedora, versions 6.x and newer, stores resources on disk in an OCFL repository, and OCFL requires a case-sensitive filesystem. By default, Windows and Mac systems uses case-insensitive filesystems. If you intend to run Fedora on such a system, you have to make sure to meet 1 of the following requirements:
  • Locate Fedora home on a case-sensitive volume. This is an exercise for the reader.
  • Do not use Archival Groups. Case related resource name collisions can only happen when dealing with resources contained within the same Archival Group.
  • Do not name two different resources the same but with different casing.
• A relational database for storing indexes such as see this page (Database Cache) for more information, Fedora currently supports:
  • MariaDB
  • MySQL
  • PosgreSQL

Installation

The primary method of running Fedora is the Servlet Container Install

Using Docker

If you'd like to run using docker you can simply install docker and then run the following command:

For the latest bleeding edge development:

docker run -p8080:8080 --name=fcrepo fcrepo/fcrepo

For a particular version:

docker run -p8080:8080 --name=fcrepo fcrepo/fcrepo:<tag>

Fedora is now running at http://localhost:8080/fcrepo. Log in with username "fedoraAdmin" and password "fedoraAdmin".

For all the available docker configuration options for fcrepo see the fcrepo-docker README.

Servlet Containers

The Fedora web-application can be installed by dropping the WAR file into a servlet v6 container, such as Tomcat 10+ or Jetty 12.
For details on installing Fedora to those containers, see the Deployment guide.

Next Steps

Once Fedora is running, 

• Explore the feature tour
• Explore the web-application configuration options
• Explore enabling repository asset authorization
• Explore setting up an external search index