Git Hosting

2026-01-30T09:09:58Z

Cdkauder: Updated link to the gitea actions comparison page

We have a [https://git.csclub.uwaterloo.ca Gitea] instance running on [[Machine List#caffeine|caffeine]]. You can sign in via LDAP to the web interface. Projects used by CSC as a whole are owned by the [https://git.csclub.uwaterloo.ca/public public] organization, except for website-committee related repos, which are owned by the [https://git.csclub.uwaterloo.ca/www www] org.

== Installation Details ==
<code>/etc/gitea</code> on caffeine contains the configs for Gitea. It's installed as a Debian package, with additional files in <code>/var/lib/gitea/</code>and a systemd service at <code>/lib/systemd/system/gitea.service</code>.

There is a custom locale (used to define CSC-custom strings in some pages) at <code>/var/lib/gitea/custom/options/locale/locale_en-US.ini</code> that may need to be updated when the Gitea APT package is updated. To update this, run the <code>update_custom_locale.sh</code> in that directory (as root).

== Usage ==
"It's basically GitHub"

- raymo

=== SSH keys ===
It is recommended to setup [https://git.csclub.uwaterloo.ca/user/settings/keys SSH keys] so that you do not have to enter your password each time you push to a repo. Once you have uploaded your public key, add the following to your ~/.ssh/config:
<pre>
Host csclub.uwaterloo.ca
HostName csclub.uwaterloo.ca
IdentityFile ~/.ssh/id_rsa
User git
</pre>
(Replace ~/.ssh/id_rsa by the location of your private SSH key.) Now you should be able to clone, push and pull over SSH.

== Continuous Integration ==
We have a Gitea Act Runner integrated directly into Gitea. It should have identical syntax as Github Actions (see [https://docs.gitea.com/usage/actions/comparison to GitHub Actions - Gitea]).

Before Spring 2025:
We are running a CI server at https://ci.csclub.uwaterloo.ca. It uses OAuth via Gitea for logins, so you need to have logged in to Gitea first. See https://docs.drone.io/ for documentation. All you have to do is create a .drone.yml file in your repo, then enable CI on the repo from the CSC Drone website. There is an example [https://git.csclub.uwaterloo.ca/merenber/drone-test here].

== Pushing and pulling from the filesystem ==
(for syscom only)
<br>
If you need to keep the ability to push/pull from the filesystem, in addition to Gitea, you will need to take the following steps.
In this example, we are migrating a repo called 'public/repo.git', which is a folder under /srv/git on caffeine (which is a symlink to /users/git).
The way we're doing this right now is kind of hacky, but it works:
<ol>
<li>Clone the original repo locally: <code>git clone /srv/git/public/repo.git</code></li>
<li>Delete the old repo (from phosphoric-acid, which has no_root_squash): <code>rm -rf /srv/git/public/repo.git</code></li>
<li>Create a new repo with the name 'repo' from the Gitea web UI. This should create a bare repository at <code>/srv/git/public/repo.git</code>. (Make sure you choose the 'public' org from the dropdown.)</li>
<li>
Push the original repo to the new remote:
<pre>
cd repo
git remote add gitea https://git.csclub.uwaterloo.ca/public/repo.git
git push gitea master
</pre>
</li>
<li>
Remove any git gooks which require gitea:
<pre>
rm $(grep -IRl gitea /srv/git/public/repo.git/hooks)
</pre>
</li>
<li>
Change file permissions:
<pre>
chown -R git:git /srv/git/public/repo.git
chmod -R g+w /srv/git/public/repo.git
</pre>
You will need to do this from phosphoric-acid (due to NFS root squashing).
</li>
</ol>
Note that the repo folder SHOULD be owned by git:git. Anything else will likely break Gitea. (If a user pushes something to the folder and their umask doesn't allow group members to read, for example, then Gitea will be unable to read the repo.)
<br>
This means that only trusted users should be in the git group - ideally, only syscom members.

== Troubleshooting ==
If you are having trouble pulling/pushing with SSH and have something like this when trying <code>ssh git@csclub.uwaterloo.ca</code>:

<pre>
PTY allocation request failed on channel 0
shell request failed on channel 0
</pre>

Just restart <code>gitea.service</code> on caffeine.

Music

2026-01-24T02:07:25Z

Cdkauder: Added config and details for bluetooth fix

Music is run off <code>powernap</code>, since that's the computer with the speakers attached.

Office staff/termcom/syscom permissions are required to play music in the office.

We also have MPD available, however this method is rarely used after 2022. ''kids these days''

==How to play music==

# Run <code>ssh [watid]@powernap.csclub.uwaterloo.ca</code>
# Run <code>bluetoothctl</code>
# Type <code>pairable on</code> and <code>discoverable on</code> into the console to enable pairing and discovery
# Connect to <code>powernap</code> from your device
# Respond yes to all the prompts on the terminal from <code>powernap</code>
# Type <code>trust [device_mac]</code> to automatically allow audio from your device next time
# You should be able to play audio like a normal audio device now
# After you are done pairing, type <code>discoverable off</code> to prevent distortions. See troubleshooting section for detail

==How to control audio server==
powernap uses PipeWire and can talk to PulseAudio client. To set volume, mute some audio stream, or change output setting, use an office terminal and do:

<pre>PULSE_SERVER=powernap.csclub.uwaterloo.ca pavucontrol</pre>

If you're using a Linux laptop then this should work too.

== MPD Controls ==
To view the keybindings of ncmpcpp, press F1 while it's running.
The number keys switch between tabs in it.

*1 is current playlist
*2 is browsing files
*3 is search
*4 is browsing the media library
*5 is browsing saved playlists, etc.

You can add your own ''absolutely legitimately obtained'' music by copying them to <code>/music</code> on powernap. Then type <code>u</code> in ncmpcpp to refresh the database.

==Termcom Info==

*We require https://github.com/hrkfdn/mpdas to get scrobbling working as it "official" last.fm integration was removed from mpd in 2013.
**n.b. https://github.com/hrkfdn/mpdas/issues/58
*To control the mixer on other terminals, use <code>PULSE_SERVER=nullsleep pavucontrol</code>
*The official last.fm account credentials are stored in the exec password spot :)

== Technical Details ==
The pipewire user starts 3 services on boot with logind linger enabled, this allows for running user services on boot without the user being signed in.

# pipewire
# wireplumber
# pipewire-pulse-custom (the normal pipewire-pulse.service is perma masked, this just exec pipewire-pulse after the pipewire service)

Since pipewire doesn't support both multi user playback and bluetooth, we have opted to use pipewire-pulse to handle local playback on powernap, while pipewire handles all the bluetooh.

wireplumber is the pipewire session manager, it let's you change your sinks volume, what sources go to which sinks, etc.

=== Bluetooth ===
To configure wireplumber for bluetooth the following config was used<syntaxhighlight>
monitor.bluez.properties = {
bluez5.roles = [ a2dp_sink a2dp_source bap_sink bap_source hsp_hs hsp_ag hfp_hf hfp_ag ]
bluez5.codecs = [ sbc sbc_xq aac ldac aptx aptx_hd aptx_ll aptx_ll_duplex faststream faststream_duplex ]
bluez5.enable-sbc-xq = true
bluez5.hfphsp-backend = "native"
bluez5.enable-msbc = true
bluez5.enable-hw-volume = true
bluez5.headset-roles = [ hsp_hs hsp_ag hfp_hf hfp_ag ]

}
wireplumber.profiles = {
main = {
monitor.bluez.seat-monitoring = disabled
}
}
</syntaxhighlight>

=== Unit pipewire-pulse-custom ===
<syntaxhighlight>
[Unit]
Description=Custom pipewire-pulse service to get around pipewire-pulse.socket being perma masked
Requires=pipewire.service

[Service]
ExecStart=pipewire-pulse

[Install]
WantedBy=default.target
</syntaxhighlight>

==Troubleshooting Playback==
*Sometimes after connecting to powernap there is immense distortion and audio playback is not bearable.
*To fix type <code>discoverable off</code> in the bluetoothctl environment (after a successful connection of course).
*Current consensus is that this happens because there are so many bluetooth devices in MC that the compute on powernap gets overwhelmed.

CSCWiki - User contributions [en]

Git Hosting

Music