Skip to main content

Onboarding

This document primarily serves as a guide for new committers to Apache OpenDAL™.

Upon receiving an invitation email from OpenDAL PMC, a new committer should consider whether accepting. If they decide in favor, they should select "Reply All" and express their decision.

Submit CLA​

  1. Download the ICLA from https://www.apache.org/licenses/contributor-agreements.html#clas. If a corporation assigns employees to work on an Apache project, please download the CCLA.
  2. Complete the ICLA based on your particulars. Please note:
  3. Sign the document by hand or by electronic signature
  4. Send your icla.pdf (and icla.pdf.asc if PGP-signed) to secretary@apache.org.

After waiting for some time, you will receive an email notifying you that your CLA has been successfully recorded.

Setup ASF Account​

When receiving an email with the subject "Welcome to the Apache Software Foundation" from root@apache.org, we can begin setting up an ASF account.

Setup LDAP Password​

  1. Go to https://id.apache.org/reset/enter and enter your ApacheID.
  2. Check your email and click the provided link to reset your password.
  1. Navigate to https://gitbox.apache.org/boxer/ and enter your ApacheID and password.
  2. Click "Authenticate with GitHub" and follow the given instructions to link your ASF account to GitHub.
  3. Check your email titled "[GitHub] @asfgit has invited you to join the @apache organization" and accept the invitation.
  4. Wait momentarily, and the website will refresh on its own.
  5. (If you do not enable 2FA on GitHub) Please follow the instruction.

Your ApacheID and GitHub ID will now both appear on https://gitbox.apache.org/boxer/. Congrats on successfully linking your ASF account to GitHub!

Email Settings​

Note: Apache does not provide a mailbox directly.

Receive Email​

You can change your forwarding email address at Apache Account Utility Platform

Send Email​

To send emails using your apache.org address, configure your email client to leverage the mail-relay service. For specifics, refer to this guide.

Here's an illustration for Gmail users:

  1. Open Gmail settings and select "See all settings".
  2. Navigate to "Accounts and Import", then locate "Send mail as".
  3. Click "Add another email address" and enter your name and apache.org email address.
  4. Input the SMTP server information:
    • SMTP Server: mail-relay.apache.org
    • Port: 587
    • Username: your apacheID
    • Password: your apacheID password
    • Secured connection using TLS
  5. Click "Add account" and you will receive an email from Gmail that need to confirm.

Gmail Settings

Subscribe to Mailing List​

  1. Send email to dev-subscribe@opendal.apache.org
  2. You will receive an email with the subject "confirm subscribe to dev@opendal.apache.org"
  3. Reply to the email with "Confirm" in the body

If you receive an email with the subject "WELCOME to dev@opendal.apache.org", you have successfully subscribed to the mailing list.

Setup 1password​

OpenDAL offers a 1Password open-source team license for conducting local integration tests (Thanks to 1Password!). Once you have been added to OpenDAL's committer list, one of the PMC members will invite you to join the team.

Please download your preferred clients to begin using it. You can create your own vault that is accessible only by yourself. Neither the 1password team nor OpenDAL PMC members can access it unless you choose to share it.

Summit PR for News​

Add your name and GitHub ID to the website/community/news.md file and submit a PR for the website.