Skip to main content

Create App from GitLab

Appliku integrates with GitLab using token-based authentication. You create a personal access token in GitLab and provide it to Appliku, which then accesses your repositories for deployment.

Prerequisites​

  • A GitLab account (gitlab.com or self-hosted) with access to the repository you want to deploy
  • At least one server connected to Appliku

Step 1: Create a GitLab Access Token​

Before connecting GitLab to Appliku, you need to generate an access token:

  1. Log in to your GitLab account
  2. Go to Settings (click your avatar in the top-right corner) > Access Tokens
  3. Click Add new token
  4. Give the token a descriptive name (e.g., "Appliku deployment")
  5. Set an expiration date (or leave blank for no expiry, if your GitLab instance allows it)
  6. Under Scopes, select read_repository
  7. Click Create personal access token
  8. Copy the token immediately -- it will not be shown again

Step 2: Set Up GitLab Credentials in Appliku​

  1. Go to Applications > Add Application > GitLab
  2. Click Setup Credentials
  3. Enter your GitLab access token
  4. If you are using a self-hosted GitLab instance, provide the instance URL
  5. Save the credentials

Appliku will verify the token and connect to your GitLab account.

Step 3: Create the Application​

Once your GitLab credentials are configured:

  1. Select a repository from the list of accessible repositories
  2. Choose a branch to deploy from
  3. Select a server or cluster for deployment
  4. Name your application
  5. Click Create Application

Push-to-Deploy​

Push-to-deploy is supported for GitLab applications. Appliku registers a webhook in your GitLab repository that triggers a deployment on every push to the configured branch.

Token Permissions​

The read_repository scope is the minimum required for Appliku to clone and build your code. If your token expires or is revoked, deployments will fail until you update the credentials with a new token.

Next Steps​

After creating your application: