Skip to main content

Create App from GitHub

Appliku integrates with GitHub through OAuth, giving you access to your repositories for one-click deployments with automatic push-to-deploy.

Prerequisites​

  • A GitHub account with access to the repository you want to deploy
  • At least one server connected to Appliku

Step 1: Navigate to Add Application​

Go to Applications in the sidebar, then click Add Application. Select GitHub as the source.

Step 2: Set Up GitHub Credentials​

If this is your first time connecting GitHub, you need to authorize Appliku:

  1. Click Setup Credentials
  2. You will be redirected to GitHub's OAuth authorization page
  3. Review the permissions and click Authorize
  4. You will be redirected back to Appliku with your GitHub account connected

Once authorized, Appliku can access your repositories. You only need to do this once per GitHub account.

Step 3: Select Repository and Branch​

After connecting your GitHub account:

  1. Select a repository from the dropdown list of your accessible repositories
  2. Choose a branch to deploy from (e.g., main, master, or any feature branch)

Step 4: Choose a Server​

Select the server (standalone mode) or cluster (cluster mode) where you want to deploy the application.

Step 5: Name Your Application​

Give your application a name. This name is used to:

  • Identify the application in the Appliku dashboard
  • Generate the default subdomain (your-app-name.applikuapp.com)

Application names must be unique within your team and consist of lowercase letters, numbers, and hyphens.

Step 6: Create the Application​

Click Create Application. Appliku will:

  1. Set up the connection to your GitHub repository
  2. Register a webhook for push-to-deploy
  3. Create the application in your dashboard

Push-to-Deploy​

Push-to-deploy is enabled by default for GitHub applications. Every time you push to the configured branch, Appliku automatically triggers a new deployment.

You can verify the webhook is active in your GitHub repository under Settings > Webhooks.

Next Steps​

After creating your application, you need to configure it before deploying: