Set up
Last updated
Last updated
Avion uses the highly secure OAuth 2 protocol to allow us to authenticate as you with GitHub. This allows Avion to see your repos, projects and organizations.
Before you dive in, please note that the user that you choose to authenticate with GitHub must be either the owner of the repo — if you're syncing to a repo project, or an owner of the organization — if you're syncing to an organization project.
A repo can only have one owner, but an organization can have multiple.
Read about permissions required.
You might choose to create a specific integration user that can be controlled by a trusted member of your business. This mitigates against the situation where you have to delete a user that Avion is authenticated with if a person leaves your business. More info.
If you are unsure which project type to select, please refer to the What Types of GitHub Projects Are Supported? page.
Depending on which project type you selected, you will now need to select either a repo or an organization that contains the project you are looking to sync to.
Select the particular project you would like Avion to import issues and cards from, push stories to and sync up with.
Map your Avion workflow to your GitHub states. Advice and info.
Just to help you visualise this, here are the two states in either tool:
Import your existing project backlog from GitHub. Advice and info.
Please note the following:
Closed issues will not be imported
Only issues that are on the project board that are not in a triage state will be imported
Closed milestones will not be imported (specific to repo-based classic projects)
You can re-import again later, so any issues that may get added in GitHub can always be pulled back into Avion.
