Home Infra and the Incubator (edit)

Infra and the Incubator

What Infra is

The Infrastructure team (Infra) manages the systems and hardware that run the services that the ASF and its projects depend on. Infra also reviews requests to install new systems or software on ASF machines. It's a small team, distributed across many time zones. Someone is on duty at all hours to respond to emergency issues.

Infra and incubating projects

Your mentor is your first stop in figuring out technical issues for your incubating project. They can explain, based on long experience, how to get the best out of the ASF systems, machines, and services. However, if the mentor is not available, members of the new project can move forward the process of setting up project resources.

Phase 1: The first steps to establish a new podling

Podling bootstrap file

The very first task is for a mentor or champion to bootstrap the project via the podlings.xml file, that tracks all current and previous podlings.

This file is located at here. You may use existing entries as a primer.


DNS entry ($projectname.apache.org) is required for the podling website and mailing lists to work. Request this once podlings.xml has been updated, by filing a JIRA ticket with Infra. See the next point before completing the ticket.

The Domain Name System (DNS) is a hierarchical and decentralized naming system for computers, services, or other resources connected to the Internet or a private network. It associates various information with domain names assigned to each of the participating entities.


Activate LDAP for the project by filing a JIRA ticket with Infra. Typically you can request both LDAP and DNS in the same ticket.

The Lightweight Directory Access Protocol (LDAP) is an open, vendor-neutral, industry standard application protocol for accessing and maintaining distributed directory information services over an Internet Protocol network.

Phase 2: Mailing lists

Mailing lists are an integral part of the Apache Way. Projects must have them set up before requesting other development resources Typically, a project will need three lists; private@ for podling PMC communications and/or security issues, dev@ for development discussions, and commits@ for code commit notifications.

Projects may also request separate lists for issues, pull requests, and users (this is very important once you do your first software release and begin to develop a user community) if they like, and can do so at any time.

The project's mentor(s) can can request mailing lists once DNS and LDAP are set up, through SelfServe.

It takes about twelve hours after the mentor makes the request before the mailing lists become active. This gives Infra time to catch and deal with any errors in the requests.

Phase 3: Requesting new project resources or moving existing ones

Code repositories

Version control 99% of time requires a github.com transition of existing repositories to the github.com/apache/ organization

For NEW repositories or if you wish to copy existing code without transferring github stars, etc,, your mentor can request new repositories via SelfServe.

For existing repositories on GitHub that needs migration, file a JIRA ticket with Infra.

Bug tracking

You can enable GitHub issues (and wikis) via our .asf.yaml service (.asf.yaml is a configuration file that a project may use to control various features such as notification schemes, website staging, GitHub settings, and Pelican builds, if it uses that technology). This is a per-repo feature. The project can request a JIRA instance via SelfServe.

Confluence Wiki

Every project can have a dedicated space on the Apache Confluence wiki. Project participants can use the space to develop documentation, share planning and process documents, and work collaboratively. They can opt to make some pages in their space available to the public. Request a Confluence wiki space for the project via SelfServe.


Standard practice is to create a web site repository via SelfServe, and then use .asf.yaml for publishing on $project.apache.org.

Contacting Infra

If there is a problem, or you need Infra to do something, the best option is to start a Jira ticket assigned to Infra. That helps us and you track progress on whatever the thing is.

For more informal contact, you can use the asfinfra Slack channel in the Apache Slack workspace, or send an email. Further details are here.

Copyright 2023, The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache® and the Apache feather logo are trademarks of The Apache Software Foundation...