With your personal account, you can easily manage and share packages with a few colleagues, however, if you plan to use Gemfury as a team, we recommend creating a separate Organization account. These accounts are specifically tailored for team and business collaboration with the following features:
- Multi-ownership for shared account administration
- Extended/custom collaborator permissions
- Separate email address for billing receipts
- Collaboration-friendly pricing
Creating an Organization account
To allow fine-grained access control and auditing, Organization accounts do not support direct login with a password, but rather need to be accessed through each member’s personal account.
Thus, to create and manage your new Organization, you will first need to log in to your personal account or create a new one. This account will act as the owner of the Organization. Once you have your personal account, you will create your organization and build your team.
Converting an existing Personal account
You may have already started using Gemfury with a Personal account and have populated it with packages and team members. Don’t fret, you will not need to start from the beginning.
You can convert an existing Personal account into an Organization while keeping all the packages and collaborators intact. If you choose to go through this process, you will see the following transformations to your account:
- Change your account type into an Organization
- Assign initial ownership to another personal account of your choice
- Disable email/password access to the converted account
During the conversion process, you can change the username and billing email of the account, but most importantly, you will choose the first owner. You will be giving unrestricted access to the owner, while you will lose the ability to log in to this account directly.
The owner you choose needs to be another existing account - one of your colleagues or a new personal account that you have prepared to replace the converted one.
Organization accounts use the business pricing schedule, so you will need to update your payment plan once you convert your personal account into an organization. Like with any other plan change, we will prorate your payment for the remainder of the billing period and the difference will be factored into your next invoice.
Organization ownership and access
Unlike personal accounts, organizations are not accessed directly via a password login, but rather by using Gemfury’s collaboration platform. You will perform operations on the Organization account by using your personal account authentication.
Organizations on the Dashboard
Log in to your personal account and use the accounts drop-down to select the Organization. The Dashboard will switch to show the listing of packages and menus for that Organization. Based on your packages, manage collaborators, and/or change settings and billing information.
Organizations via the command-line
You can use the Organization’s username in the Repo-URL for uploads
and deployments, or with the
--as option when issuing CLI commands.
Please use your personal authentication token when accessing an Organization
All the settings for the account can be manipulated by the collaborators who have been given the Owner permission. Billing (including receipts and invoices), collaboration, and other settings for an Organization are fully separate from equivalent settings in the personal accounts of the owners.
Deploying packages from an Organization account is no different than from a Personal account. You can use the authentication token from Account Settings and build a Repo-URL for your deployments. The deployment URL that you see in the Repos section of the Dashboard uses your personal authentication token – be careful sharing it.
In addition to regular authentication tokens, Organization accounts support generating multiple deploy tokens that can be used to grant read-only access to the account’s repositories.
Please contact us if you have any questions or suggestions about how Organization accounts can fit into your team’s development and release process.