Current Release

This documentation covers the current version of Fedora. Looking for another version? See all documentation.

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 11

    java -version
    openjdk version "11.0.5" 2019-10-15
    OpenJDK Runtime Environment (build 11.0.5+10-post-Ubuntu-0ubuntu1.1)
    OpenJDK 64-Bit Server VM (build 11.0.5+10-post-Ubuntu-0ubuntu1.1, mixed mode, sharing)
  • Servlet 3.0 container such as:
  • A case-sensitive filesystem. Fedora 6 stores resources on disk in an OCFL repository, and OCFL requires a case-sensitive filesystem. By default, Windows and Mac systems uses case-insenstive 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.


There are two primary ways of deploying Fedora. The first, One-Click Run, is an easy way to get Fedora running to test out the basic features. The second, Servlet Container Install, is the approach to be used in production installations.

One-Click Run

  1. Download the latest executable webapp "one-click-run" from releases
  2. Either double-click on the download, or run the following command to start Fedora

    java -jar fcrepo-webapp-<version>-jetty-console.jar
  3. Once Fedora is seen to be running at the following URL, start exploring the feature tour


    Note, port 8080 is the default. Replace that port number in the above URL if you used a different value.

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:6.0.0-beta-1

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

Servlet Containers

Alternatively, instead of deploying Fedora via the "one-click run", the Fedora web-application can be installed by dropping the WAR file into a servlet 3 container, such as Tomcat 9 or Jetty 9.
For details on installing Fedora to those containers, see the Deployment guide.

Next Steps

Once Fedora is running, 

  • No labels