Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Community documentation on setting up a local OSF instance

See original GitHub issue

I think it would be very useful to have a document with the best practices of people setting up a local OSF instance at their home institute. In the issue list I noticed several people have worked on this in the past (,,,,, The Docker Compose document is a good starting point for a local installation. However, my experience is that it does not cover specific application configurations, like when to create a and what values to change.

For me it is also not clear how to setup working with files on a local installation. I guess this goes via Waterbutler, but any input or best practices on this topic would be highly appreciated. Also which storage option is used as default (Amazon S3, or any other object storage system like Swift, Ceph or Minio)

@umardraz, @mfraezz, @yacchin1205, @sloria, @mattvw, @antonwats, @jpkeith4, @HiroyukiNaito, I would appreciate it if you can share you experiences with setting up a local OSF installation. Did you succeed to setup an instance? What was the most difficult part? Is it still in use?

Issue Analytics

  • State:open
  • Created 5 years ago
  • Comments:10 (1 by maintainers)

github_iconTop GitHub Comments

pdurbincommented, Sep 11, 2019

I have a half baked dream of spinning up software related to Dataverse (you can deposit data from OSF into Dataverse) using the Kubernetes config in . I’m coming at the from the Dataverse developer perspective of wanting to ensure that integrations are tested regularly. Right now I think we rely on users to tell us if we broke something. 😄

I got this idea of spinning up related software in our ecosystem in Kubernetes from @craig-willis who created which is described at and has “specs” various software (including Dataverse, CKAN, Globus, Jupyter, etc.) at

I have no idea if anyone has any time to work on any of this though. It’s just a thought.

I agree that docs are crucial. Maybe someone from the OSF community could apply for

Hi, @RightInTwo !!! 👋

Johnetordoffcommented, Jun 8, 2021

@CaptainSifff if your organization is interested in using a personal OSF instance, I suggest they look at the implementation for That’s essentially the only large group that has forked our project that is being actively used and is open source. If you’d like to use just a portion of our functionality I’d recommend integrating with our services as is, such as WaterButler and modular-file-renderer, or forking one of those services. I’d also strongly recommend using our new Oauth2 capabilities to utilize our file storage and REST API.

We are somewhat cagey about writing precise instructions for setting up because the data model and external integrations we are writing change frequently and we simply don’t have the resources to walk people through the process individually, but if you are representing an institution and want more details please contact us at and we and talk about what is best for your use case. Mention that you had a conversation with John Tordoff and name the organization you represent and will answer your questions to the best of our ability.

Read more comments on GitHub >

github_iconTop Results From Across the Web

Basic Protocol: Open and Reproducible Research on OSF
The following protocol gives the author step by step instructions for using the free and open source OSF to create a data management...
Read more >
Issues with making separate OSF site production ready · Issue ...
Hello, We're trying to set up our own OSF site in-house, using the repository, ... Community documentation on setting up a local...
Read more >
Open Science Framework (OSF) - PMC - NCBI - NIH
DOCUMENTATION AND TECHNICAL REQUIREMENTS​​ As an open source service, the OSF has freely available documentation and support. The OSF home page has a...
Read more >
Keirsten E. Smith, MD | OSF Healthcare
Biography. A native of Michigan, Dr. Keirsten Smith returned to her home state with a deep desire to serve the local community.
Read more >
Family Access - OSF HealthCare
If you are a child age 12-17 and no longer wish for a parent or guardian to have proxy access, please contact your...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Post

No results found

github_iconTop Related Hashnode Post

No results found