using cgit on tilde.club
deepend


cgit gives every tilde.club member a simple, read‑only web view of their
public Git repositories. Any repo you put in ~/public_git/ and end with
.git is automatically shown at

    https://tilde.club/~<username>/git/

Below is the quick‑start plus a few tips.

------------------------------------------------------------------------

1  Create the public_git directory (once)

    $ mkdir -p ~/public_git

The web server is already allowed to traverse ~/public_git, so you do
not have to chmod anything manually.

------------------------------------------------------------------------

2  Add a repository

Only bare repos are accepted (they have no working tree inside them).

    # create a brand‑new bare repository
    $ cd ~/public_git
    $ git init --bare hello.git

or push an existing project:

    $ cd ~/my/project
    # add tilde as a remote and mirror‑push everything
    $ git remote add tilde ssh://<username>@tilde.club/~/public_git/project.git
    $ git push --mirror tilde

You can repeat for as many repos as you like; just keep each one
directly in ~/public_git/ and make sure the name ends with .git.

------------------------------------------------------------------------

3  Browse your repos

    Index page   : https://tilde.club/~<username>/git/
    Single repo  : https://tilde.club/~<username>/git/<repo>.git/

Example for user deepend:

    https://tilde.club/~deepend/git/          # lists everything
    https://tilde.club/~deepend/git/hello.git/  # specific repo

The header will say ~deepend Git Repositories, commits are clickable,
diffs are highlighted, and the cloning URL is shown near the top right.

------------------------------------------------------------------------

4  Update a repository

Because the repo is bare you push into it; cgit shows the new state
immediately.

    $ git push tilde main          # normal
    $ git push --mirror tilde      # full mirror (branches + tags)

------------------------------------------------------------------------

5  Remove a repository

Simply delete or rename the directory:

    $ rm -rf ~/public_git/oldstuff.git

The entry disappears from the index on the next page load.

------------------------------------------------------------------------

FAQ

Can I hide a repo from the list?

Move it somewhere else in your home directory or make it non‑bare. cgit
only scans ~/public_git/*.git.

Why bare repos only?

Internal .git/ directories inside non‑bare repos confuse cgit’s scanner
and produce broken links like /repo.git/.git/. Bare repos avoid that and
are the normal way to publish Git over HTTP.

Clone / pull URL?

Use SSH for write access:

    ssh://<username>@tilde.club/~/public_git/<repo>.git

or plain HTTPS for read‑only:

    https://tilde.club/~<username>/git/<repo>.git

------------------------------------------------------------------------

Happy hacking, and show off your code! Questions? #club on
irc.newnet.net or mail root@tilde.club[1].

[1] mailto:root@tilde.club