Creating Projects¶

Projects are the core unit in GoForge. Each project represents an application that you want to build and deploy from a Git repository.

Creating a Project¶

1. Navigate to Projects in the sidebar
2. Click New Project
3. Fill in the project details:
4. Name -- A descriptive name for your project
5. Repository URL -- The Git repository URL
6. Git Source -- Optional linked Git provider
7. Default Branch -- Branch to deploy from (defaults to main)
8. Dockerfile Path -- Path to Dockerfile (defaults to Dockerfile)
9. Build Context -- Docker build context directory (defaults to .)

Connecting a Git Source¶

After creating a project, connect it to a Git repository:

1. Go to the project's Settings > Git Source
2. Choose your provider (GitHub, GitLab, or Gitea)
3. Authenticate with the provider
4. Select the repository and branch

Supported Providers¶

Environments¶

Each project starts with a default environment. Environments allow you to manage different configurations (e.g., staging vs. production).

Managing Environments¶

1. Go to the project page
2. Click the Environments tab
3. Create or select an environment
4. Configure environment variables specific to that environment

Environment Variables¶

Set configuration values for your application:

1. Navigate to the environment's Variables tab
2. Add key-value pairs
3. Toggle Secret for sensitive values (passwords, API keys)
4. Click Save

Secret variables are encrypted at rest using AES-256-GCM.

DATABASE_URL=postgres://...
API_KEY=secret123
DEBUG=false

Project Settings¶

Deleting a Project¶

Deleting a project will:

1. Stop and remove all running containers
2. Delete all deployments and logs
3. Remove all environments and variables
4. Delete the git source configuration
5. Remove the project record