Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rubenhoenle/nixoserver
NixOS Server configuration
https://github.com/rubenhoenle/nixoserver
homelab linux nixos server
Last synced: 7 days ago
JSON representation
NixOS Server configuration
- Host: GitHub
- URL: https://github.com/rubenhoenle/nixoserver
- Owner: rubenhoenle
- Created: 2023-12-28T13:11:54.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-11-04T14:34:12.000Z (13 days ago)
- Last Synced: 2024-11-04T15:34:30.066Z (13 days ago)
- Topics: homelab, linux, nixos, server
- Language: Nix
- Homepage:
- Size: 144 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/rubenhoenle/NixOServer/actions/workflows/build.yaml)
[](https://github.com/rubenhoenle/NixOServer/actions/workflows/flake-update.yaml)
# NixOS Server Configuration
## Rebuilding
`nixos-rebuild switch --build-host root@mandalore --target-host root@mandalore --flake ".#mandalore"`
`nixos-rebuild switch --target-host root@scarif --flake ".#scarif"`
## Startup
`ssh root@ -p 2222`
_Don't forget to specify root as username when connecting to the initrd ssh session!_
## Backups
### Offsite backup
```bash
# start
systemctl start restic-backups-fullbackup
# view status
systemctl status restic-backups-fullbackup
# view snapshots
restic-fullbackup snapshots
# browse snapshots
restic-fullbackup ls latest /var/lib/
# restore
/run/current-system/sw/bin/restic-fullbackup restore --target / latest
```
### Local harddrive backup
```bash
# IMPORTANT: the mount/unmount pkgs are only available for the root user
# mount the HDD backup drive
hdd-mount
# starting the HDD backup
systemctl start restic-backups-hdd
# showing the status of the HDD backup
systemctl status restic-backups-hdd
# unmount the HDD backup drive
hdd-unmount
# showing the snapshots of the HDD backup
restic-hdd snapshots
# restoring the backup from the HDD
restic-hdd restore latest --target /
```
## Podman containers
To view the logs of the podman containers specified in the nix config, use the following command:
```bash
# show containers
sudo podman ps -a
# show logs for container
sudo podman logs -f
```
## Services
### Paperless service
```bash
# export
/var/lib/paperless/data/paperless-manage document_exporter /home/ruben/paperless-export-001
```
### Git server
```bash
# create a repo on the server
sudo -u git bash -c "git init --bare ~/myproject.git"
# then you can use it via the following url
[email protected]:myproject.git
```
## Troubleshooting
- In case of systemd temp files and directories not created properly when testing backups, run `sudo systemd-tmpfiles --create` on the server.
## SSH Tunnelling
```bash
# port forward localhost:3000 to mandalore:2020
ssh mandalore -L 3000:localhost:2020 -fN
```