Environment Variables
This document lists the environment variables used to configure the Kleinkram application. These variables are typically defined in a .env file in the root directory.
Server Configuration
| Variable | Description | Default |
|---|---|---|
SERVER_PORT | The port on which the backend server listens. | 3000 |
Service URLs
These URLs are used for communication between services and for generating links.
| Variable | Description | Default |
|---|---|---|
FRONTEND_URL | The URL where the frontend application is accessible. | http://localhost:8003 |
DOCS_URL | The URL where the documentation site is accessible. | http://localhost:4000 |
BACKEND_URL | The URL where the backend API is accessible. | http://localhost:3000 |
MinIO Configuration (Object Storage)
Configuration for MinIO, which is used for S3-compatible object storage.
| Variable | Description | Default |
|---|---|---|
MINIO_USER | The username for MinIO access. | minioadmin |
MINIO_PASSWORD | The password for MinIO access. | minioadmin |
MINIO_ACCESS_KEY | The access key for S3 clients. | pMEKIOCnYJhmssiKZDGU |
MINIO_SECRET_KEY | The secret key for S3 clients. | ECnXGyUR5ZrPsxeD5JEWxtI1CMZFMJ8kTJMMAQ5B |
MINIO_DATA_BUCKET_NAME | The bucket name for main data storage. | data |
MINIO_DB_BUCKET_NAME | The bucket name for database dumps/backups. | dbdumps |
MINIO_ARTIFACTS_BUCKET_NAME | The bucket name for build artifacts. | artifacts |
MINIO_ENDPOINT | The hostname or IP address of the MinIO service. | localhost |
Database Configuration
Configuration for the PostgreSQL database.
| Variable | Description | Default |
|---|---|---|
DB_HOST | The hostname of the database server. | database |
DB_PORT | The port of the database server. | 5432 |
DB_DATABASE | The name of the database. | dbname |
DB_USER | The database username. | dbuser |
DB_PASSWORD | The database password. | dbuserpass |
DATA_SOURCE_NAME | The full connection string/DSN for TypeORM/Postgres. | postgresql://dbuser:dbuserpass@database:5432/dbname?sslmode=disable |
DEV | Set to true to enable development features (verbose logging, etc.). | true |
TypeORM Configuration
| Variable | Description | Default |
|---|---|---|
ENTITIES | Glob pattern to locate entity files. | dist/**/*.entity.js |
Seeding Configuration
| Variable | Description | Default |
|---|---|---|
SEED | Set to true to populate the database with initial seed data on startup. | true |
Authentication Configuration
| Variable | Description | Default |
|---|---|---|
VITE_USE_FAKE_OAUTH_FOR_DEVELOPMENT | Set to true to enable the mock OAuth provider for local dev. | true |
GOOGLE_KEY_FILE | Path to the Google Cloud service account key file. | google-service-account.json |
GOOGLE_CLIENT_ID | Google OAuth Client ID. | - |
GOOGLE_CLIENT_SECRET | Google OAuth Client Secret. | - |
GITHUB_CLIENT_ID | GitHub OAuth Client ID. | - |
GITHUB_CLIENT_SECRET | GitHub OAuth Client Secret. | - |
JWT_SECRET | Secret key used to sign and verify JWT tokens. | SECRET |
Docker & Registry Configuration
| Variable | Description | Default |
|---|---|---|
DOCKER_HUB_USERNAME | Username for Docker Hub authentication. | - |
DOCKER_HUB_PASSWORD | Password for Docker Hub authentication. | - |
VITE_DOCKER_HUB_NAMESPACE | Restricts allowed Docker images to a specific namespace. | - |
ARTIFACTS_UPLOADER_IMAGE | Docker image used for uploading artifacts. | rslethz/kleinkram:artifact-uploader-latest |
DOCKER_GID | The group ID of the docker group on the host system. | 984 |