wehub-resource-sync
173 lines
3.6 KiB
Markdown
173 lines
3.6 KiB
Markdown
## Add to NixOS system configuration
|
|
|
|
Add DBX as a flake input and include the package in `environment.systemPackages`.
|
|
|
|
### `flake.nix`
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
|
|
|
dbx = {
|
|
url = "github:t8y2/dbx";
|
|
inputs.nixpkgs.follows = "nixpkgs"; # optional
|
|
};
|
|
};
|
|
|
|
outputs = { self, nixpkgs, dbx, ... }: {
|
|
nixosConfigurations.my-machine = nixpkgs.lib.nixosSystem {
|
|
system = "x86_64-linux";
|
|
modules = [
|
|
./configuration.nix
|
|
{
|
|
environment.systemPackages = [
|
|
dbx.packages.x86_64-linux.dbx-desktop
|
|
];
|
|
}
|
|
];
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
### Apply
|
|
|
|
```bash
|
|
sudo nixos-rebuild switch --flake .#my-machine
|
|
```
|
|
|
|
---
|
|
|
|
## Add via Home Manager
|
|
|
|
This method installs DBX for a specific user through [Home Manager](https://github.com/nix-community/home-manager).
|
|
|
|
> [!NOTE]
|
|
> The `inputs.nixpkgs.follows = "nixpkgs"` line is **optional**.
|
|
> It prevents Nix from downloading a second copy of nixpkgs, but it also makes
|
|
> DBX ineligible for the upstream binary cache (it will be built locally).
|
|
> Remove that line if you prefer to download a pre-built binary.
|
|
|
|
### `flake.nix` (standalone Home Manager)
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
|
|
|
home-manager = {
|
|
url = "github:nix-community/home-manager";
|
|
inputs.nixpkgs.follows = "nixpkgs";
|
|
};
|
|
|
|
dbx = {
|
|
url = "github:t8y2/dbx";
|
|
inputs.nixpkgs.follows = "nixpkgs"; # optional
|
|
};
|
|
};
|
|
|
|
outputs = { self, nixpkgs, home-manager, dbx, ... }: {
|
|
homeConfigurations."youruser" = home-manager.lib.homeManagerConfiguration {
|
|
pkgs = nixpkgs.legacyPackages.x86_64-linux;
|
|
system = "x86_64-linux";
|
|
modules = [
|
|
{
|
|
home.packages = [
|
|
dbx.packages.x86_64-linux.dbx-desktop
|
|
];
|
|
}
|
|
];
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
### `flake.nix` (NixOS + Home Manager as a NixOS module)
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
|
|
|
home-manager = {
|
|
url = "github:nix-community/home-manager";
|
|
inputs.nixpkgs.follows = "nixpkgs";
|
|
};
|
|
|
|
dbx = {
|
|
url = "github:t8y2/dbx";
|
|
inputs.nixpkgs.follows = "nixpkgs"; # optional
|
|
};
|
|
};
|
|
|
|
outputs = { self, nixpkgs, home-manager, dbx, ... }: {
|
|
nixosConfigurations.my-machine = nixpkgs.lib.nixosSystem {
|
|
system = "x86_64-linux";
|
|
modules = [
|
|
./configuration.nix
|
|
home-manager.nixosModules.home-manager
|
|
{
|
|
home-manager.users.youruser = {
|
|
home.packages = [
|
|
dbx.packages.x86_64-linux.dbx-desktop
|
|
];
|
|
};
|
|
}
|
|
];
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
> Replace `youruser` with your actual Linux username and `my-machine` with your hostname.
|
|
|
|
### Apply (standalone)
|
|
|
|
```bash
|
|
home-manager switch --flake .#youruser
|
|
```
|
|
|
|
### Apply (NixOS module)
|
|
|
|
```bash
|
|
sudo nixos-rebuild switch --flake .#my-machine
|
|
```
|
|
|
|
---
|
|
|
|
## Development Shell
|
|
|
|
If you are contributing to DBX or building it from a local clone, the flake provides a fully configured development shell with Rust, Node.js, pnpm, and all GTK/WebKit system libraries:
|
|
|
|
```bash
|
|
git clone https://github.com/t8y2/dbx
|
|
cd dbx
|
|
nix develop
|
|
```
|
|
|
|
Inside the shell:
|
|
|
|
| Task | Command |
|
|
|---|---|
|
|
| Desktop app (Tauri) | `pnpm install && pnpm dev:tauri` |
|
|
| Web frontend only | `pnpm dev:web` |
|
|
| Web backend only | `pnpm dev:backend` |
|
|
| Release build | `pnpm tauri build` |
|
|
|
|
---
|
|
|
|
## Building from Source
|
|
|
|
Build the `dbx-desktop` package directly from the flake:
|
|
|
|
```bash
|
|
nix build github:t8y2/dbx#dbx-desktop
|
|
# or, from a local clone:
|
|
nix build .#dbx-desktop
|
|
```
|
|
|
|
The resulting binary is available at `./result/bin/dbx`.
|
|
|
|
---
|