Account management

Create and manage your Argos account, sign up with Google, GitHub, or GitLab, and pick the plan that fits.

When you sign up for Argos, you create an account that manages your projects and subscriptions. You can sign up with Google, GitHub, or GitLab — see Pricing plans for what each plan includes.

Sign up with a Git provider

Argos supports GitHub and GitLab as Git providers. When you sign up with one, you authorize Argos to access it, and that connection becomes your default login method. After signing up, you can manage login methods in your Personal Settings.

Login methods and connections

To manage login connections:

1. Select your profile picture in the top-right corner of the dashboard.
2. Choose Settings.
3. Open the Authentication section.

The Authentication section of your account settings.

Logging in with a passkey

A passkey lets you sign in with your fingerprint, face, screen lock, or a hardware security key instead of a code or a Git provider. You can register several and use any of them.

For setup and login instructions, see Passkeys.

Logging in with SAML Single Sign-On (SSO)

SAML SSO allows team members to log in with their organization’s identity provider.

For setup and login instructions, see SAML Single Sign-On.

Creating a project

You can create a project in two ways from the New Project page — import an existing Git repository, or start with just a name and connect a repository later.

Import a Git repository

Choose Import a Git repository and select a Git provider (GitHub or GitLab) to import a repository. Argos links the project to that repository, which enables pull request comments and status checks.

Create without Git

Choose Create a project without Git, enter a Project name, and select Create project.

A project without a connected repository still receives builds through the Argos CLI using its project token. Features that depend on a repository — such as pull request comments — become available once you link one.

The New Project page with two paths: import a Git repository or create a project without Git

Connect a repository later

To link a repository to a project you created without Git:

1. Open the project's Settings.
2. Go to the Connected Git Repository section.
3. Select a Git provider and choose the repository to connect.

You can disconnect or change the repository from the same section at any time.

Teams

Teams let you collaborate on projects and share resources.

Creating a team

1. Select the scope selector in the top-left of the navbar.
2. Choose Create new team.
3. Enter a team name.
4. By default, new teams start on the Pro plan. To switch plans, contact us.

Team settings and members can be managed from the team’s settings page.

Free Pro trial

Your first team automatically starts with a 14-day free trial of Argos Pro.

The trial includes unlimited users and 35,000 free screenshots.

Team membership

Owners can invite new members using an invitation link found in Team Settings.

See Roles and permissions for details.

Inviting teammates

1. From the dashboard, select your team from the scope selector.
2. Open the Settings tab and go to the Members section.
3. Select Invite Link and copy the generated link.
4. Share the link with anyone you want to join the team.

Public repositories on Argos are accessible to everyone.

Leaving a team

You cannot leave a team if you are the last owner or the last member.

To leave a team:

1. If necessary, assign another owner first.
2. Go to your team's Settings tab and go to the Members section.
3. Scroll to Leave Team and select Leave Team.
4. Confirm the action.
5. If you are the last member, delete the team instead.

Deleting a team

1. Remove all team projects.
2. Open the team's Settings tab.
3. Scroll to Delete Team and select Delete Team.
4. Confirm the action.

Managing emails

To access email settings:

1. Select your avatar in the top-right corner.
2. Choose Settings.
3. Scroll to the Emails section.
4. From here, you can add, remove, or change your primary email.

Adding a new email address

1. In the Emails section, select Add Another.
2. Verify the new address using the link sent to your inbox.
3. Once verified, any email address on your account can be used to log in.

Your account email addresses.

Changing your primary email address

Your primary email is used for Argos notifications.

To change it:

• Add and verify a new email.
• Open the dot menu next to the address and choose Set as Primary.

Setting your primary email address.

Removing an email address

To remove an address, use the Delete option in the dot menu.

Note: You must set a new primary email before removing the current one.

Resolving "Account already attached" issues

If you see the error message:

Your GitHub|GitLab|Google account is already linked to another Argos account

it means the provider account you are trying to connect is already associated with a different Argos account.

Steps to fix

1

Log out of Argos

Select your avatar in the top-right corner, then select Log out.

2

Log back in with your provider

From the login page, choose Continue with GitHub|GitLab|Google.

This will sign you into the Argos account that currently owns your provider link.

3

Disconnect or delete the account

Once logged in, select your avatar in the top-right corner, choose Settings.

Select Authentication from the sidebar.

Find the GitHub|GitLab|Google connection, select the vertical ellipsis (⋮), and select Disconnect.

Alternatively, if the account is no longer needed, you can delete it entirely from Account Settings → General.

4

Log out again

Return to the login page.

5

Reconnect with the right account

Log back in with the account you want to use.

From the Authentication section, link your provider account.

After completing these steps, your provider account will be linked to the correct Argos account.