Getting started with Zenhub
New to Zenhub? This onboarding series covers the basics of getting started with the Zenhub app. Feel free to jump to the lessons of your choice or watch the series entirely through.
Lesson 1: Creating an account
If you’re new to Zenhub, here’s how you can create an account:
- Go to Zenhub.com and click “Try for free”
- Input your work email and create a password, then click “Create an account”
- Tell us what type of project you’re using Zenhub for and what your role is
- Tell us your organization’s name
- Click “Connect to your GitHub account” to access all of Zenhub’s features. See lesson 3 for more details.
Lesson 2: Connecting to GitHub
Zenhub is better with GitHub connected. Not only does Zenhub automatically populate your board with issues directly from your GitHub repositories, but it also will now grant you access to some of Zenhub users' favorite features.
With GitHub connected, you will have access to:
- Automate time-consuming processes like sprint planning and updating workflows
- Track your team's productivity gains over time with real-time reports
- Enable your team to work closer to their codebase with our browser extension
How to connect with GitHub:
- Click "Connect with GitHub"
- If you are the organization's owner, you should see a "Grant" button beside the organization – click this. If you are not the owner, click "Request." This will notify the owner with an automated email to grant you access. We recommend also contacting them directly to ensure they received the email.
- Once you've selected "Grant" or "Request," you can go ahead and click the "Authorize ZenhubIO" button. If you're the organization owner, no other action is required – welcome to Zenhub!
- If you are waiting on your organization owner to authorize Zenhub, they will need to go to GitHub's organization settings and click "third party access." Zenhub should appear as a third-party app. From here, they must click "Review" and then "Grant."
For more information on authorizing GitHub with Zenhub, read this blog or reach out to email@example.com if you have any questions. For information on security and permissions in GitHub, please skip to lesson 3.
Lesson 3: Permissions and security overview
With the close integration Zenhub has with GitHub and over 8000 teams using Zenhub worldwide, security is a top priority for us, and we know it is for you too. Read the FAQs about security and permissions below, and don’t hesitate to contact our support team at firstname.lastname@example.org if you have any further questions.
What is the level of access Zenhub has to a user’s source code?
The repository scope that Zenhub requests when connecting to GitHub is full-read and write access. We require this level of access to provide features like issue templates and an overall better experience for our users.
While we recognize that this level of access allows us to read a user’s code, at no point does Zenhub ever read your code or pull requests.
How does Zenhub keep my data safe?
We understand that this access puts a big responsibility on our shoulders to manage users’ assets securely. On the DevOps team, we have several encryption and access control policies that ensure assets are kept safe.
Zenhub is also certified with SOC 2 Type II designation, a highly regarded security certification verified by third-party professionals. Learn more about our SOC 2 designation here.
Lesson 4: Inviting teammates
Give your teammates the advantage of getting more productive in Zenhub by inviting them to collaborate with you. Here’s how to invite your team:
- Click “Invite your team” on the left-hand navigation
- Either copy the link to your workspace and send it to your teammates or invite your teammates by email. That’s it!
Lesson 5: Creating a workspace and adding a repo
Workspaces allow you to collaborate with your team to ship better software. Your workspace is where you will keep your GitHub issues organized within Zenhub. You can create workspaces both in the Zenhub web app or in GitHub using the Zenhub browser extension.
How to create a workspace
- To create a new workspace, click on your organization name and select the “Create a new workspace” button.
- From here, you can give your workspace a name. Note: No two Zenhub workspaces can be of the same name, so choose a name unique to your team.
- Give your workspace a description (optional)
- Add GitHub repositories to the workspace by selecting “Add repositories.” You can add repos from all organizations with access to Zenhub. To change the organization you’re searching for, click the avatar in the bottom left corner to see all available organizations.
Lesson 6: Adding multiple repos
Software projects often span across multiple repositories. To accommodate this, you can add multiple repos into your workspace, including those in other organizations, to get one unified view of all work being done.
How to merge multiple repositories
- Click the “Repo” drop-down on your Zenhub board.
- Using the “Add repo” button, you can select up to 5 repos at a time to add to your workspace. To add repos from other organizations, click the avatar on the bottom left corner to see all available organizations.
All issues from new repos will be added to your board's "New issues" pipeline. Bulk move issues into their appropriate pipelines by leveraging filters and multi-actions. To copy the pipeline groupings from another workspace for this repo, use automated workflows to automate the movement of issues into different pipelines.
We hope you found this guide helpful in getting started with Zenhub! If you have any questions, feel free to reach out to our support team at email@example.com. Need a bit more help getting set up with Zenhub? Schedule a chat with an onboarding specialist here.
Give your software team an edge
We surveyed over 260 software professionals to uncover the trends, priorities and opportunities of today's disruptive software teams.