docs.coopcloud.tech/docs/app-config-guide.md

3.1 KiB

title
App config guide

Keycloak

How do I setup a custom theme?

Check this approach.

Nextcloud

How do I customise the default home page when logging in?

  • Delete the dashboard app since it is so corporate
  • Follow these docs to set the default files list for each user in the Files app
  • Configure a defaultapp in your config.php or use apporder

How do I integrate with Keycloak SSO?

Use this plugin. You can use this trick (see "Cryptic Usernames" work-around) to get proper usernames.

TODO(decentral1se): copy over keycloak client config and nextcloud config.php

Why is my synchronisation client freezing on the "grant access" step?

Please see this ticket.

How can I customise the CSS on the NC?

There is some basic stuff in the admin settings.

To go a little deeper, you can use this handy app.

Drone

Generating deploy keys

We normally do something like the following.

$ ssh-keygen -t ed25519 -C drone@swarm.autonomic.zone

When you're loading them into Drone, make sure to use the right name of the organisation when using drone orgsecret add.

How to change orgsecret values

First, get your Drone CLI tool downloaded and the environment configured.

$ export DRONE_SERVER=https://drone.example.com
$ export DRONE_TOKEN=$(pass show your-pass-store-path)
$ curl -L https://github.com/drone/drone-cli/releases/latest/download/drone_linux_amd64.tar.gz | tar zx

Then you can do things like:

$ ./drone orgsecret ls
$ ./drone orgsecret add someorg my_deploy_key @my_private_key_file

How to enable build failure notifications

Add this to your .drone.yml file. See the plugin docs for more.

- name: notify rocket chat
  image: plugins/slack
  depends_on: ["mybuild"]
  settings:
    webhook:
      from_secret: rc_builds_url
    username: foobar
    channel: "builds"
    template: "{{repo.owner}}/{{repo.name}} build failed: {{build.link}}"
  when:
    status:
      - failure

!!! warning

You must include valid names of pipelines in your `depends_on` list field.
This is so that the notification will wait until all other pipelines are
run before performing the notification logic.

Skipping CI builds

Add [ci skip] into the git commit message. You don't have to run builds if you don't want to.

Gitea

TODO

Peertube

How do I wire up Keycloak SSO?

Use this plugin.

How do I develop a custom theme?

See this approach.