djv.sh

Personal homepage built with Leptos and Axum.

Development

Enter the dev shell and start the server:

nix develop
just dev

For remote development, tunnel ports 3000 (app) and 3001 (hot-reload):

ssh -L 3000:localhost:3000 -L 3001:localhost:3001 user@host

Commands

just check  # format, lint, and test (Rust + Nix)
just fmt    # format code
just lint   # run clippy, statix, deadnix
just test   # run tests
just build  # release build

Deployment (NixOS)

1. Add flake input

{
  inputs.djv.url = "github:djvcom/djv/stable";
}

The stable tag points to the latest commit that passed the full CI build pipeline, including the Nix package build. This ensures your NixOS config only updates to known-good versions.

2. Import module and enable service

{ inputs, ... }:
{
  imports = [ inputs.djv.nixosModules.default ];

  services.djv = {
    enable = true;
    environment = "production";
  };
}

3. Configure reverse proxy

services.traefik.dynamicConfigOptions.http = {
  routers.djv = {
    rule = "Host(`djv.sh`)";
    service = "djv";
    tls.certResolver = "letsencrypt";
  };
  services.djv.loadBalancer.servers = [{ url = "http://127.0.0.1:3000"; }];
};

Module options

Option	Default	Description
services.djv.enable	false	Enable the service
services.djv.listenAddress	"127.0.0.1:3000"	Address and port to listen on
services.djv.environment	"production"	Deployment environment (deployment.environment.name)
services.djv.opentelemetryEndpoint	"http://127.0.0.1:4318"	OTel collector endpoint
services.djv.vcsRevision	""	Git commit hash for telemetry
services.djv.vcsRefName	""	Git branch or tag name for telemetry

Observability

Traces are exported via OTLP to the configured endpoint. Resource attributes include:

• service.name / service.version - from Cargo.toml
• deployment.environment.name - from module config
• vcs.ref.head.revision / vcs.ref.head.name - git commit and branch at build time

Licence

MIT