Introduction
Welcome to Humanitec!
We’re excited that you’ve joined us on your Internal Developer Platform journey. To get you started and off on the right path, we’ve prepared this handy getting started guidebook to walk you through the fundamentals of all things Humanitec.
In this guidebook we include not only conceptual and philosophical articles, but also useful hands-on tutorials and guides to key ideas and technical components. We regularly update this document with new information and examples, so please feel free to ask for an updated copy at any time!
If you have questions or need support, contact our Support.
Basic concepts
This section explores keys conceptual topics related to Humanitec and its components. We will focus in on key definitions, concepts, and philosophy that drives the product vision and best
What is a Platform Orchestrator
Why Humanitec
An overview of the key value points of the Humanitec Platform Orchestrator.
Introduction to Score
Understanding the OSS product Score and how it fits into Internal Developer Platforms.
Humanitec definitions
How Humanitec defines key elements of the Platform Orchestrator and Score. This is key to understanding the components that make up the Platform Orchestrator and how they related to the system as a whole.
- What are Applications? (Docs)
- What is Dynamic Configuration Management? (Docs)
- What are Environments? (Docs)
- What are Organizations? (Docs)
- Humanitec terms glossary (Docs)
Humanitec components
A technical deep-dive exploring the key components of Humanitec's Platform Orchestrator and Score.
- Building a platform - Overview (Docs)
- Using a platform - Overview (Docs)
- Starting with reference architectures (Tutorial)
Getting started
Now, let’s get our hands dirty and start building with Humanitec. This section covers basic usage, configuration, and day-to-day management with the Platform Orchestrator and Score.
Project and environment setup
Quick-start creating a new application, workloads, and setting up  environments.
- Quickstart - Create + deploy a new application (Tutorial)
- Starting with reference architectures (Tutorial)
- Scaffold new workload and create environments (Tutorial)
Organization management
Creating and managing an organization on the Humanitec platform, including security and access control.
Managing applications and services
Quick-start creating a new application, workloads, and setting up  environments.
Resource Definitions
Configuring services and associated dependencies.
- Resource Definitions for related Applications (Tutorial)
- What are Resources? (Article)
- What are Resource Definitions? (Docs)
- Active Resources (Docs)
Deploying Applications
Deploying applications to different environments, via the API, UI, or Score. Includes information on rollbacks and diff generation.
- Daily developer activities (Tutorial)
- Managing deployments (Docs)
- Generate diffs pre-deploy (Repo)
- Rollbacks (Docs)
Workload Configurations with Score
A deep-dive on using Score, the agnostic workload specification, with Humanitec.
Advanced features
Let’s deep-dive some more advanced functionality, setup, and features.
CI/CD integrations
Setting up CI/CD pipelines for automated deployments using Humanitec's Platform Orchestrator.
The Humanitec Operator
An overview of installation, management, and usage of the Humanitec Operator for external secret store utilization.
Advanced RBAC
Configuring user access and permissions, including inbuilt RBAC and utilizing basic IAM configurations.
Other advanced functionalities
Review of other commonly requested and demonstrated advanced features.
- Merging multiple workloads in a single Score file (Repo)
- Configuring shared ALB within Humanitec (Repo)
- AWS integration examples (Repo)
- Workload Profiles (Docs)
- Dependent Resources (Docs)
Additional Support & Training
Have questions, or need help?
Customer Support
Humanitec Customer Support is available any time. You can also find an interactive chat inside the Humanitec UI to contact us!
Additional training or hands-on sessions
Your contact on Humanitec’s Customer Success team can put you in touch with an Enablement Engineer to give you the context and hands-on help you need! Reach out to them to schedule a session.
Documentation and examples
Humanitec Docs     Humanitec Blog
Learning path: Master Your Internal Developer Platform
