Self-hosted pastebin powered by Git, open-source alternative to Github Gist.
Go to file
Jacob Hands 2f8435892e Add config for default branch name (#171)
Co-authored-by: Thomas Miceli <27960254+thomiceli@users.noreply.github.com>
2024-01-04 18:06:19 +01:00
.github/workflows Add binaries cross compile in CD (#113) 2023-09-26 15:13:58 +02:00
docker config.yml with Docker (#131) 2023-10-15 08:14:34 +02:00
docs Add config for default branch name (#171) 2024-01-04 18:06:19 +01:00
internal Add config for default branch name (#171) 2024-01-04 18:06:19 +01:00
public Bug fixes (#184) 2024-01-04 18:06:19 +01:00
scripts Add binaries cross compile in CD (#113) 2023-09-26 15:13:58 +02:00
templates Bug fixes (#184) 2024-01-04 18:06:19 +01:00
.dockerignore Better build/watch 2023-04-06 13:55:04 +02:00
.gitattributes Tweaked project structure (#88) 2023-09-03 00:30:57 +02:00
.gitignore Add binaries cross compile in CD (#113) 2023-09-26 15:13:58 +02:00
CHANGELOG.md v1.5.3 2023-11-20 18:49:46 +01:00
Dockerfile config.yml with Docker (#131) 2023-10-15 08:14:34 +02:00
LICENSE Initial commit 2023-03-14 16:22:52 +01:00
Makefile Add clickable Markdown checkboxes (#182) 2024-01-04 18:06:19 +01:00
README.md Add config for default branch name (#171) 2024-01-04 18:06:19 +01:00
config.yml Add config for default branch name (#171) 2024-01-04 18:06:19 +01:00
go.mod Add clickable Markdown checkboxes (#182) 2024-01-04 18:06:19 +01:00
go.sum Add clickable Markdown checkboxes (#182) 2024-01-04 18:06:19 +01:00
opengist.go Add config for default branch name (#171) 2024-01-04 18:06:19 +01:00
package-lock.json Bug fixes (#184) 2024-01-04 18:06:19 +01:00
package.json Add embedded gists & JSON gist data/metadata (#179) 2024-01-04 18:06:19 +01:00
postcss.config.js Add embedded gists & JSON gist data/metadata (#179) 2024-01-04 18:06:19 +01:00
tailwind-embed.config.js Add embedded gists & JSON gist data/metadata (#179) 2024-01-04 18:06:19 +01:00
tailwind.config.js Miscellaneous front changes (#93) 2023-09-06 23:36:44 +02:00
tsconfig.json Convert Javascript to Typescript 2023-04-03 23:37:54 +02:00
vite.config.js Add embedded gists & JSON gist data/metadata (#179) 2024-01-04 18:06:19 +01:00

README.md

Opengist

Opengist

Opengist is a self-hosted pastebin powered by Git. All snippets are stored in a Git repository and can be read and/or modified using standard Git commands, or with the web interface. It is similiar to GitHub Gist, but open-source and could be self-hosted.

DocumentationDemo

GitHub release (latest SemVer) License Go CI Go Report Card

Features

  • Create public, unlisted or private snippets
  • Init / Clone / Pull / Push snippets via Git over HTTP or SSH
  • Revisions history
  • Syntax highlighting ; markdown & CSV support
  • Like / Fork snippets
  • Search for snippets ; browse users snippets, likes and forks
  • Download raw files or as a ZIP archive
  • OAuth2 login with GitHub, Gitea, and OpenID Connect
  • Restrict or unrestrict snippets visibility to anonymous users
  • Docker support
  • More...

Quick start

With Docker

Docker images are available for each release :

docker pull ghcr.io/thomiceli/opengist:1

It can be used in a docker-compose.yml file :

  1. Create a docker-compose.yml file with the following content
  2. Run docker compose up -d
  3. Opengist is now running on port 6157, you can browse http://localhost:6157
version: "3"

services:
  opengist:
    image: ghcr.io/thomiceli/opengist:1
    container_name: opengist
    restart: unless-stopped
    ports:
      - "6157:6157" # HTTP port
      - "2222:2222" # SSH port, can be removed if you don't use SSH
    volumes:
      - "$HOME/.opengist:/opengist"

You can define which user/group should run the container and own the files by setting the UID and GID environment variables :

services:
  opengist:
    # ...
    environment:
      UID: 1001
      GID: 1001

Via binary

Download the archive for your system from the release page here, and extract it.

# example for linux amd64
wget https://github.com/thomiceli/opengist/releases/download/v1.5.2/opengist1.5.2-linux-amd64.tar.gz

tar xzvf opengist1.5.2-linux-amd64.tar.gz
cd opengist
chmod +x opengist
./opengist # with or without `--config config.yml`

Opengist is now running on port 6157, you can browse http://localhost:6157

From source

Requirements : Git (2.28+), Go (1.20+), Node.js (16+)

git clone https://github.com/thomiceli/opengist
cd opengist
make
./opengist

Opengist is now running on port 6157, you can browse http://localhost:6157

Documentation

The documentation is available in /docs directory.

License

Opengist is licensed under the AGPL-3.0 license.