Skip to content

OpenGist

OpenGist is a self-hosted and open-source pastebin powered by Git.

URL
gists.f13.io
Docs
opengist.io/docs
Availability
By Invitation / Team Access

Need an account?

Accounts are available to the public upon request, with reason. If you’d like to request an account, please fill out this form.

Tech Notes

Make an account/grant access to OpenGist

Users must log in to OpenGist using their Forgejo (git.f13.io) account. Prior to requesting/granting access to OpenGist, users must have an active account on Forgejo. If they do not yet have an account on Forgejo, they can request an account at git.f13.io/user/sign_up.

Once you’ve verified that the user has a Forgejo account, add them to the gists-access team within the apps-access organization in Forgejo. (You can use this deeplink to quickly jump to that team.)

Make an account admin

Since Gists logins are processed through Forgejo (git.f13.io), we use teams within the apps-access organization to grant access. To grant a user admin rights within OpenGist, add them to the gists-admin team within the apps-access organization in Forgejo. (You can use this deeplink to quickly jump to that team.)

Manually make an account admin

If you, for whatever reason, need to make an account an admin without using the Forgejo team, follow these steps:

  1. Have the user you want to make an admin sign in with SSO at least once so that they are present in the users table.
  2. Follow steps 1-4 to edit the opengist.db SQLite database.
  3. In the users table, locate the row with the user you want to modify. Find the is_admin column for that user and change its value to 1.
  4. Follow steps 6-7 above to reload the modified db file.
  5. Have the user log in to OpenGist with SSO, and make sure they can access the admin panel.

Enable local login

By default, OpenGist is configured to use only OIDC for users to log in. In case of emergency (IdP outage), you may need to log in with the local break-glass account (1Password). Follow these steps to temporarily enable the local login form:

  1. SSH to centaur with a sudo-capable account.
  2. Navigate to /srv/opengist and run docker compose down to stop the Docker container.
  3. Navigate to /srv/opengist/opengist and locate the opengist.db SQLite database file.
  4. Open opengist.db using a tool such as DB Browser or TablePlus.
  5. In the admin_settings table, find the disable_login_form key and change its value to 0.
  6. Put the updated DB file back in /srv/opengist/opengist.
  7. Navigate to /srv/opengist and run docker compose up -d to start the Docker container.
  8. Log in to OpenGist using a local user account.