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 .
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. .
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.
Just to help you visualise this, here are the two states in either tool:
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.
If you are unsure which project type to select, please refer to the page.
Map your Avion to your GitHub states. .
Import your existing project backlog from GitHub. .