title: Onboarding sidebar_position: 2
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
- 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.
- Complete the ICLA based on your particulars. Please note:
- The address field should be filled out accurately and in detail.
- You need to choose a unique ApacheID that hasn't been taken. Check https://people.apache.org/committer-index.html to see which IDs are still available.
- Sign the document by hand or by electronic signature
- Manually sign a printed copy, then scan it to produce a pdf.
- Digitally draw a signature on the document: Detail Instruction.
- Sign the document using PGP: Detail Instruction.
- 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
- Go to https://id.apache.org/reset/enter and enter your ApacheID.
- Check your email and click the provided link to reset your password.
Link ASF Account to GitHub
- Navigate to https://gitbox.apache.org/boxer/ and enter your ApacheID and password.
- Click “Authenticate with GitHub” and follow the given instructions to link your ASF account to GitHub.
- Check your email titled “[GitHub] @asfgit has invited you to join the @apache organization” and accept the invitation.
- Wait momentarily, and the website will refresh on its own.
- (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:
- Open Gmail settings and select “See all settings”.
- Navigate to “Accounts and Import”, then locate “Send mail as”.
- Click “Add another email address” and enter your name and apache.org email address.
- Input the SMTP server information:
- SMTP Server: mail-relay.apache.org
- Port: 587
- Username: your apacheID
- Password: your apacheID password
- Secured connection using TLS
- Click “Add account” and you will receive an email from Gmail that need to confirm.
Subscribe to Mailing List
- Send email to dev-subscribe@opendal.apache.org
- You will receive an email with the subject “confirm subscribe to dev@opendal.apache.org”
- 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.
OpenDAL committers can also self-register to join the OpenDAL 1Password team by visiting https://opendal.1password.com/teamjoin/invitation/DHRDX3DG45HDTNMYK63BK5BTQM and completing the signup with their apache.org email address.
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.