Getting Started

This guide follows the current product flow in your frontend and backend.

Instead of one generic “connect repository” wizard, A8S starts by asking what you want to create:

Monolithic project
Microservice project
Database deployment

Sign-in is handled through Keycloak. In the current app, GitHub and GitLab are the primary repository-linked login paths, and other brokered providers can exist if your Keycloak realm is configured for them.

Prerequisites

Before you begin, make sure you have:

An A8S account that can sign in through your Keycloak-backed login flow
A GitHub or GitLab repository for monolith or microservice projects
Database details ready for the database path: engine, version, size, name, username, and password

Quickstart

Open your A8S instance and complete the Keycloak sign-in flow.

After sign-in, you land in the dashboard workspace where projects, deployments, notifications, monitoring, and profile tools are grouped together.

Click New Project

From the dashboard, open New Project.

The first screen asks you to choose an architecture:

Monolithic for one repo and one deployable app
Microservice for repo-driven multi-service setup
Database for managed database provisioning

Finish the Matching Setup Flow

The next screen changes based on what you picked:

Monolithic Open the import/config flow, connect the repository, and finish the project configuration.
Microservice Choose GitHub or GitLab, select a repository, then continue into the service-oriented setup flow.
Database Pick the database engine, deployment mode, version, size, credentials, and review the generated connection profile settings before provisioning.

Deploy or Provision

Once submitted:

Monolith and microservice projects continue through the platform delivery pipeline used by your environment
Database deployments are accepted asynchronously and provisioned in the background, including storage and service readiness checks

Use the Detail Pages

After creation, manage your runtime from the workspace detail views:

Project detail sections Deployments, Logs, Analytics, Domains, and Settings
Database detail connection profile, built-in console access, credentials, and backup history

What You Can Do Next

Read Deployments for the current monolith, microservice, and database runtime flow
Read Projects & Environments for the current workspace structure and project management model
Read Authentication for how sessions, profile sync, and sign-in currently work