Compare commits

3 Commits

Author SHA1 Message Date
f3ea2e14d1 Add line breaks 2026-02-22 02:07:37 +00:00
2d26b45791 linger 2026-02-22 03:54:39 +02:00
67578b23d0 init docs 2026-02-22 03:50:15 +02:00
5 changed files with 84 additions and 1 deletions

View File

@@ -1,3 +1,4 @@
# 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

5
docs/add-user.md Normal file
View File

@@ -0,0 +1,5 @@
don't forget to
```bash
sudo loginctl enable-linger $USER
```

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
```

16
docs/podman.md Normal file
View File

@@ -0,0 +1,16 @@
# 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)
Maybe (just maybe) you'll need to run this thing (but I still not ceratin if it's necessary):
```sh
systemctl --user enable --now podman.socket
```

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 prs of other people
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