docs #1

Merged
miko089 merged 4 commits from init into main 2026-02-22 12:02:32 +00:00
4 changed files with 74 additions and 1 deletions

View File

@@ -1,3 +1,4 @@
# space-infra # space-infra
Infrastructure repo for this server ## Docs
docs folder includes some documentation about how to use server. Please read docs and ask questions if you don't understand how to use smth directly or in issues

44
docs/packages.md Normal file
View File

@@ -0,0 +1,44 @@
# Packages
## Why? What have you done to suffer so much?
Idk any other ways to let all users access individual package managers, so you'll have to use Nix. Sorry
## How?
I installed nix-env which is available for every user, but it has disgusting commands, so I suggest bash and fish users paste this
functions into their respective `~/.bashrc` and `~/.config/fish/config.fish`:
```bash
function nix-install {
nix-env -iA "$@" 2>&1 | grep -v 'evaluation warning'
}
function nix-remove {
nix-env -e "$@" 2>&1 | grep -v 'evaluation warning'
}
function nix-upgrade {
nix-env --upgrade 2>&1 | grep -v 'evaluation warning'
}
function nix-rollback {
nix-env --rollback 2>&1 | grep -v 'evaluation warning'
}
function nix-list {
nix-env -q 2>&1 | grep -v 'evaluation warning'
}
```
```fish
function nix-install
nix-env -iA $argv 2>&1 | grep -v 'evaluation warning'
end
function nix-remove
nix-env -e $argv 2>&1 | grep -v 'evaluation warning'
end
function nix-upgrade
nix-env --upgrade 2>&1 | grep -v 'evaluation warning'
end
function nix-rollback
nix-env --rollback 2>&1 | grep -v 'evaluation warning'
end
function nix-list
nix-env -q 2>&1 | grep -v 'evaluation warning'
end
```

11
docs/podman.md Normal file
View File

@@ -0,0 +1,11 @@
# Podman
## Why?
On that server we use podman instead of docker because it's:
- rootless by default
- individual for each user (you won't be able to access container of other person)
- have preinstalled k8s (which is called pod and idk why it's needed for us but it's hella cool)
## How to use?
Exactly the same as docker, but, obviously, instead of `docker` write `podman`. More documentation find [there](https://podman.io/docs)

17
docs/ports.md Normal file
View File

@@ -0,0 +1,17 @@
# Used ports
This file explains which ports are used and for what reason (please categorize them somehow and sort if possible)
## Shared usage
22 - ssh\
80 - caddy\
443 - caddy\
1024 - gitea exposed on that port inside the server (not allowed to use from outside)\
1025 - gitea exposed it's ssh on that port (therefore allowed from outside)\
## Rules
If you want to add some extra port, then please:
1. Check opened prs of other people
miko089 marked this conversation as resolved Outdated

maybe opened prs?

maybe opened prs?
2. Use 1024+ (because user for caddy isn't root and I don't want to change smth so please)
There will be more, but that's all for now