aboutsummaryrefslogtreecommitdiff
path: root/nix/README.md
diff options
context:
space:
mode:
authorKumar Damani <me@kumardamani.net>2026-08-02 01:43:25 +0000
committerKumar Damani <me@kumardamani.net>2026-08-02 01:43:25 +0000
commit43930cb8c22bc28ed64362845c5f4ebf54faabf2 (patch)
tree7351357bd38139b0267f1a4cdeff4b5143f5e89a /nix/README.md
parent3e139a0e702513f6e1145158b2695b43c8251b92 (diff)
added git with cgit
Diffstat (limited to 'nix/README.md')
-rw-r--r--nix/README.md70
1 files changed, 67 insertions, 3 deletions
diff --git a/nix/README.md b/nix/README.md
index 08d7305..a85e478 100644
--- a/nix/README.md
+++ b/nix/README.md
@@ -1,3 +1,7 @@
+# Deploy
+
+## Setup (one time)
+
Build base image:
```sh
nixos-rebuild build-image --image-variant proxmox --flake .#base
@@ -14,17 +18,77 @@ Convert to Proxmox Template.
Run TF as usual using clone against the Template.
+Generate host-keys, and age key for the host.
```sh
# first time only
./generate-keys.sh torrents--2
+```
+
+## Secrets w/ `sops`
-# edit the .sops.yaml to include the host's age key
+Edit the `.sops.yaml` to include the host's age key
+
+Create host's secrets:
+```sh
+sops secrets/torrents-2.yaml
+```
-sops secrets/rproxy-2.yaml
+## Push
+```sh
./deploy.sh torrents-2 root
```
-Sources:
+## References:
+
https://github.com/nix-community/nixos-generators
https://gist.github.com/joshleecreates/e6892ca21b0e6b7c24d96ca2a24bf23e
+
+# Hosts
+
+## torrents-2
+
+For all my Linux ISOs ofcourse.
+
+## rproxy-2
+
+Entrypoint into my home-lab services.
+
+## git
+
+Set your `sshconfig`:
+```sshconfig
+# ~/.ssh/config
+Host git.kumardamani.net
+ Port 2222
+```
+
+> Non-SSH access (https) is always read-only, and anonymous.
+
+Manage repos with:
+```sh
+ssh -t git@git.kumardamani.net
+
+== git repo manager ==
+ l) list repos
+ c) create repo
+ p) publish repo
+ h) hide repo
+ d) set description
+ x) delete repo
+ q) quit
+>
+```
+
+Without the ssh config entry, use the abs path:
+```sh
+git clone ssh://git@git.kumardamani.net:2222/srv/git/<name>.git
+```
+
+Move an existing local repo onto the server:
+```sh
+ssh git@git.kumardamani.net create <name>
+ssh git@git.kumardamani.net publish <name>
+git remote set-url origin git@git.kumardamani.net:<name>
+git push --all origin && git push --tags origin
+```