Commit c86a9eab authored by berber's avatar berber
Browse files

nextcloudPackages: edit README.md

parent 0354cb86
Loading
Loading
Loading
Loading
+22 −8
Original line number Diff line number Diff line
= Adding apps =
## Updating apps

To regenerate the nixpkgs nextcloudPackages set, run:

```
./generate.sh
```

After that you can commit and submit the changes in a pull request.

## Adding apps

**Before adding an app and making a pull request to nixpkgs, please first update as described above in a separate commit.**

To extend the nextcloudPackages set, add a new line to the corresponding json
file with the id of the app:
@@ -11,27 +23,29 @@ https://apps.nextcloud.com. The id corresponds to the last part in the app url,
for example `breezedark` for the app with the url
`https://apps.nextcloud.com/apps/breezedark`.

To regenerate the nixpkgs nextcloudPackages set, run:
Then regenerate the nixpkgs nextcloudPackages set by running:

```
./generate.sh
```

After that you can commit and submit the changes.
**Make sure that in this update, only the app added to `nextcloud-apps.json` gets updated.**

After that you can commit and submit the changes in a pull request.

= Usage with the Nextcloud module =
## Usage with the Nextcloud module

The apps will be available in the namespace `nextcloud25Packages.apps`.
The apps will be available in the namespace `nextcloud31Packages.apps` (and for older versions of Nextcloud similarly).
Using it together with the Nextcloud module could look like this:

```nix
```
{
  services.nextcloud = {
    enable = true;
    package = pkgs.nextcloud25;
    package = pkgs.nextcloud31;
    hostName = "localhost";
    config.adminpassFile = "${pkgs.writeText "adminpass" "hunter2"}";
    extraApps = with pkgs.nextcloud25Packages.apps; {
    extraApps = with pkgs.nextcloud31Packages.apps; {
      inherit mail calendar contact;
    };
    extraAppsEnable = true;