Aptible PaaS logoDocs



On Aptible, an app represents the deployment of your custom code. An app may consist of multiple Services, each running a unique command against a common codebase. Users may deploy Apps in one of 2 ways: via Dockerfile Deploy, in which you push a Git repository to Aptible and Aptible builds a Docker image on your behalf, or via Direct Docker Image Deploy, in which you deploy a Docker image you’ve built yourself outside of Aptible.

App Endpoints

App endpoints are load balancers that allow you to expose your Aptible apps to the public internet or your stack’s internal network. Aptible supports three types of app endpoints - HTTP(s), TLS, and TCP.

Container Recovery

Container recovery is an Aptible-automated operation that restarts containers that have exited unexpectedly, i.e., outside of a deploy or restart operation.


Aptible deploys all resources in Docker containers. Containers provide a consistent and isolated environment for applications to run, ensuring that they behave predictably and consistently across different computing environments.

CPU Isolation

CPU Isolation is a setting that guarantees isolated CPU threads for a given container providing greater reliability and more predictable performance. Aptible enables CPU Isolation by default on all new stacks.

CPU Limit

The CPU Limit is a type of metric that emits the max available CPU of an app or database. With metric drains, you can monitor and set up alerts for when an app or database is approaching the CPU Limit.

Database Endpoints

Database endpoints are load balancers that allow you to expose your Aptible databases to the public internet.


Aptible manages and pre-configures databases that provide data persistence. Aptible supports many database types, including PostgreSQL, Redis, Elasticsearch, InfluxDB, MYSQL, and MongoDB.

Aptible pre-configures databases with convenient features like automatic backups and encryption. Aptible offers additional functionality that simplifies infrastructure management, such as easy scaling with flexible container profiles, highly available replicas by default, and modifiable backup retention policies. These features empower users to easily handle and optimize their infrastructure without complex setup or extensive technical expertise.

Additionally, Aptible databases are managed and monitored by the Aptible SRE Team (our Enterprise plan includes 24/7 management) – including responding to capacity alerts and performing maintenance.


Log drains and metric drain allow you to connect to destinations where you can send the logs and metrics Aptible provides for your containers for long-term storage and historical review.


Environments provide logical isolation of a group of resources, such as production and development environments. Account and Environment owners can customize user permissions per environment to ensure least-privileged access. Aptible also provides activity reports for all the operations performed per environment. Additionally, database backup policies are set on the environment level and conveniently apply to all databases within that environment.

High Availability

High availability is an Aptible-automated configuration that provides redundancy by automatically distributing apps and databases to multiple availability zones (AZs). Apps are automatically configured with high availability and automatic failover when horizontally scaled to two or more containers. Databases are automatically configured with high availability using replication and clustering.

Horizontal Scaling

Horizontal Scaling is a scaling operation that modifies the number of containers of an app or database. Users can horizontally scale Apps on demand. Databases can be horizontally scaled using replication and clustering. When apps and databases are horizontally scaled to 2 or more containers, Aptible automatically deploys the containers in a high-availability configuration.


Logs are the output of all containers sent to stdout and stderr. Aptible does not capture logs sent to files, so when you deploy your apps on Aptible, you should ensure you are logging to stdout or stderr and not to log files.

Memory Limit

The Memory Limit is a type of metric that emits the max available RAM of an app or database container. Aptible kicks off memory management when a container exceeds its memory limit.

Memory Management

Memory Management is an Aptible feature that kicks off a process that results in container recovery when containers exceed their allocated memory.


Aptible captures and provides metrics for your app and database containers that can be accessed in the dashboard, for short-term review, or through metric drains, for long-term storage and historical review.


An operation is performed and logged for all changes to resources, environments, and stacks. Aptible provides activity reports of all operations in a given environment and an activity feed for all active resources.


An organization represents a unique account on Aptible consisting of users and resources. Users can belong to multiple organizations.


Platform as a Service (PaaS) is a cloud computing service model, as defined by the National Institute of Standards and Technology (NIST), that provides a platform allowing customers to develop, deploy, and manage applications without the complexities of building and maintaining the underlying infrastructure. PaaS offers a complete development and deployment environment in the cloud, enabling developers to focus solely on creating software applications while the PaaS provider takes care of the underlying hardware, operating systems, and networking. PaaS platforms also handle application deployment, scalability, load balancing, security, and compliance measures.


Resources refer to anything users can provision, deprovision, or restart within an Aptible environment, such as apps, databases, endpoints, log drains, and metric drains.


Services define how many containers Aptible will start for your app, what container command they will run, their Memory Limits, and their CPU Isolation. An app can have many services, but each service belongs to a single app.


Stacks represent the underlying infrastructure used to deploy your resources and are how you define the network isolation for an environment or a group of environments. There are two types of stacks to create environments within:

  • Shared stacks: Shared stacks live on infrastructure that is shared among Aptible customers and are designed for deploying resources with lower requirements, such as deploying non-sensitive or test resources, and come with no additional costs.
  • Dedicated stacks: Dedicated stacks live on isolated infrastructure and are designed to support deploying resources with higher requirements–such as network isolation, flexible scaling options, VPN and VPC peering, 99.95% uptime guarantee, access to additional regions and more. Users can use dedicated stacks for both production and development environments. Dedicated Stacks are available on the Growth, Scale, and Enterprise plans at an additional fee per dedicated stack.

Vertical Scaling

Vertical Scaling is a type of scaling operation that modifies the size (including CPU and RAM) of app or database containers. Users can vertically scale their containers manually or automatically (BETA).