first config

README.md

@@ -0,0 +1,114 @@
+# Nix Home Manager Configuration
+
+This repository contains a Nix home-manager flake for configuring a user environment on a remote Linux system with Nix installed. The configuration is designed for user `tbingmann` and includes custom Bash settings and direnv support.
+
+## Features
+
+- Custom Bash configuration with useful aliases and functions
+- direnv integration for project-specific environment variables
+- Git configuration
+- Essential command-line utilities
+
+## Prerequisites
+
+- Nix package manager installed on the remote system
+- Flakes enabled in Nix configuration
+
+### Enabling Required Experimental Features
+
+If you encounter errors about experimental features being disabled, you need to enable them. There are several ways to do this:
+
+1. **Temporary solution** - Add flags to each command:
+   ```bash
+   nix --extra-experimental-features "nix-command flakes" <command>
+   ```
+
+2. **Permanent solution** - Create or edit your `nix.conf` file:
+
+   For a single user:
+   ```bash
+   mkdir -p ~/.config/nix
+   echo "experimental-features = nix-command flakes" > ~/.config/nix/nix.conf
+   ```
+
+   For system-wide configuration (requires sudo):
+   ```bash
+   sudo mkdir -p /etc/nix
+   echo "experimental-features = nix-command flakes" | sudo tee -a /etc/nix/nix.conf
+   ```
+
+## Installation
+
+### Local Installation
+
+1. Clone this repository to your remote machine:
+
+```bash
+git clone https://g.t1.xyz/tb/nix-ebay-home.git ~/nix-home
+cd ~/nix-home
+```
+
+2. Apply the configuration:
+
+```bash
+# If home-manager is not installeds
+nix run github:nix-community/home-manager/release-25.05 -- switch --flake .#tbingmann
+```
+
+Alternatively, if you have home-manager installed:
+
+```bash
+home-manager switch --flake .#tbingmann
+```
+
+### Direct Installation from Git Repository
+
+You can apply the configuration directly from a Git repository without cloning:
+
+```bash
+# If home-manager is not installed
+nix --no-write-lock-file run github:nix-community/home-manager/release-25.05 -- switch --flake 'git+https://g.t1.xyz/tb/nix-ebay-home.git#tbingmann'
+
+# If home-manager is installed
+home-manager --no-write-lock-file switch --flake 'git+https://g.t1.xyz/tb/nix-ebay-home.git#tbingmann'
+```
+
+## Usage
+
+### Updating
+
+To update the configuration:
+
+#### Local repository:
+1. Modify the configuration files (`flake.nix`, `home.nix`)
+2. Run `home-manager switch --flake .#tbingmann`
+
+#### From remote Git repository:
+```bash
+# Pull latest changes from the repository
+git -C ~/.config/home-manager pull
+
+# Apply the updated configuration
+home-manager switch --flake ~/.config/home-manager#tbingmann
+
+# Or directly without pulling first
+home-manager --no-write-lock-file switch --flake 'git+https://g.t1.xyz/tb/nix-ebay-home.git#tbingmann'
+```
+
+## Customization
+
+- Edit `home.nix` to customize your home environment
+- Modify Bash configuration in the `programs.bash` section
+- Add or remove packages in the `home.packages` section
+
+## Troubleshooting
+
+If you encounter issues:
+
+1. Check that Nix flakes are enabled
+2. Ensure you're using the correct username in the configuration
+3. Run with `--debug` flag for more information:
+
+```bash
+home-manager switch --flake .#tbingmann --debug
+```