valen

a distributed version control platform

Overview

Valen is a distributed version control platform I built over the span of a few months. It was my capstone project for a self-led independent study at my university.

Stack

• Django + DRF
• SvelteKit
• NGINX
• OpenSSH
• Docker

Running Locally

Valen can be run locally with the provided docker-compose.yml file.

Prerequisites

• Install Docker
• Django Key
• Configured Database

Django

Docker handles dependencies when running with docker-compose, all that's necessary is to create an .env file in ./django/backend/

#.env
secret_key=your-secret-key
database_url=postgresql://your-postgres-db/

Database

While developing this project, I used supabase with an ipv4 pooler. They provide a free tier which should suffice for self-hosting. Otherwise, any other PostreSQL database will work fine.

Running on a Server

See prod/main