Serversinc

Applications

A guide to managing applications within the project, including deployment and configuration.

an Application defines how your software is deployed and managed on an Server. It acts as a blueprint for creating and managing Docker containers effectively.

Applications can be:

  • Built from source: using a public or private GitHub repository, cloned and built on the target server.
  • Deployed from a Docker image: pulled and run directly without source code access.

Each Application includes:

  • Labels: Metadata applied to containers for identification, routing, or automation.
  • Environment Variables: Key-value pairs passed to containers at runtime.
  • Volumes: Persistent storage mounts for container data.

Updating an Application does not automatically redeploy containers. To apply changes, you must manually trigger a redeploy from the Deployment tab.

Creating an Application

To create an Application, follow these steps:

  1. Navigate to the Applications Page: Click on "Applications" in the sidebar.
  2. Click "Create Application": This opens the Application creation form.
  3. Fill in the Details:
    • Type: Choose between "Github" (GitHub repository) or "Docker Image".
    • Name: Enter a unique name for the Application.
    • Domain: Specify the domain for the Application (optional).
    • Port: Set the port on which the Application will run (optional). 3a. Github:
    • Repository URL: Enter the URL of the GitHub repository.
    • Branch: Specify the branch to build from (default is main). 3b. Docker Image:
    • Image Name: Enter the name of the Docker image to deploy.
    • Tag: Specify the image tag (default is latest).
    • Private Registry: If using a private registry, provide the registry URL and authentication details.
  4. Configure Labels: Add any labels needed for the Application.
  5. Set Environment Variables: Add any environment variables required by the Application.
  6. Define Volumes: Specify any volumes to mount for persistent storage.
  7. Select Server: Choose the server where the Application will be deployed.