Skip to main content

Create App from Custom Git Repo

If your code is hosted on a platform other than GitHub or GitLab -- such as Bitbucket, Gitea, or a private Git server -- you can connect it to Appliku using a custom Git repository URL.

Prerequisites​

  • A Git repository accessible via HTTPS or SSH
  • At least one server connected to Appliku

Step 1: Navigate to Add Application​

Go to Applications > Add Application > Custom Git Repo.

Step 2: Provide the Repository URL​

Enter the URL of your Git repository. Appliku supports both protocols:

  • HTTPS: https://git.example.com/user/repo.git
  • SSH: git@git.example.com:user/repo.git

Step 3: Configure Access​

For HTTPS Repositories​

If the repository is private, provide credentials (username and password or token) when prompted.

For SSH Repositories​

When you select SSH access, Appliku generates an SSH key pair for this application:

  1. After creating the application, Appliku displays the public SSH key
  2. Copy this key
  3. Add it as a deploy key in your Git hosting platform:
    • Bitbucket: Repository Settings > Access keys
    • Gitea: Repository Settings > Deploy Keys
    • Other providers: Consult your provider's documentation for adding deploy keys

The deploy key only needs read access to the repository.

Step 4: Complete Application Setup​

  1. Choose a branch to deploy from
  2. Select a server or cluster for deployment
  3. Name your application
  4. Click Create Application

Push-to-Deploy​

Push-to-deploy is not automatically available for custom Git repositories since Appliku cannot register webhooks on arbitrary Git hosts.

To trigger deployments automatically, use webhooks instead. Appliku provides a unique webhook URL for each application that you can configure in your Git hosting platform to call on push events.

For manual deployments, use the Deploy button in the application dashboard.

Next Steps​

After creating your application: