Organization & Management

In this chapter, learn how to manage your organization, team members, and platform settings.

Organization

When you sign up for Hydra Deploy, a new organization is automatically created for you. An organization is the central entity where all your resources (applications, projects, deployments, etc.) are managed.

Organization Settings

Go to Settings > General to manage organization settings:

• Name - The name of your organization
• Description - An optional description of your organization
• Organization Details - Other organization-specific information

Only users with the ORG_OWNER or ORG_MANAGER role can modify these settings.

Users & Permissions

Manage who has access to your organization and what they’re allowed to do.

User Roles

Hydra Deploy has four different roles with different permissions:

Inviting Users

1. Go to Settings > Users & Permissions
2. Click on Invite User or click on an empty row in the users table
3. Select the role for the new user
4. An invite code is generated

The invited user can sign up for Hydra Deploy and use the invite code to become a member of your organization.

Invite Codes

Invite codes are a secure way to add new users without email verification.

Create an Invite Code:

1. Go to the Invite Codes tab
2. Click on Create Invite
3. Select the role that the new user will receive
4. The code is generated and displayed

Use Invite Code:

1. The new user goes to the signup form
2. Enters the invite code at “Invite Code”
3. Completes the registration

Only users with the ORG_OWNER or ORG_MANAGER role can create invite codes.

Editing and Removing Users

Edit Users:

1. Go to the Users tab
2. Click on the pencil icon behind the user
3. Change the user’s role
4. Save the changes

Remove Users:

1. Click on the trash icon behind the user
2. Confirm the removal

You cannot remove yourself and also cannot remove other ORG_OWNER users.

Environments

Environments define the environments where your applications are deployed, such as Development, Staging, and Production.

Creating Environments

1. Go to Settings > Environments
2. Click on Create New Environment
3. Give the environment a name
4. The environment is added to your list

Environment Order

The order of environments is important because it determines how they are displayed in the deployment overview:

1. Drag environments to the desired position
2. Click on Save Order to save the changes

The topmost environment will be displayed first in the deployment screen.

Environment Usage

Each project can use its own set of environments. You can also choose to use only specific environments for certain projects.

API Keys

API keys provide access to the Hydra Deploy API, which is useful for automation and integrations.

Creating an API Key

1. Go to Settings > API Keys
2. Click on Create API Key
3. Give the key a descriptive name
4. The key is generated and displayed only once

Important: Store your API key securely. You cannot view it later. If you lose a key, you must create a new one and delete the old one.

Using an API Key

Use the API key in the Authorization header of your requests:

Authorization: Bearer <your-api-key>

API keys are required for:

• Automatically creating application versions in your CI/CD pipeline
• Performing deployments via the API
• Other automated tasks

Only users with the ORG_OWNER or ORG_MANAGER role can create API keys.

Agents

Agents are programs that run on your servers and execute deployment scripts.

See the chapter Get Started for more information on installing and configuring agents.

Billing

Manage your subscription and view your usage.

Billing Overview

Go to Settings > Billing to:

• View your current subscription
• Download invoices
• Manage payment methods
• View usage statistics

Payment Methods

1. On the billing page, you see an overview of your payment methods
2. Click on the link to add a new payment method (handled via Stripe)

Invoices

Invoices are generated monthly based on your usage:

• Number of active projects
• Number of deployments
• Other usage metrics

You can download invoices as PDF or have them sent via email.

Only users with the ORG_BILLING, ORG_MANAGER, or ORG_OWNER role have access to the billing section.