Introduction to Opengist

Opengist is a self-hosted pastebin powered by Git, offering an open-source alternative to GitHub Gist. This platform allows users to create and manage public, unlisted, or private snippets using standard Git commands or the web interface.

Key Features:

• Create and manage snippets with syntax highlighting, markdown, and CSV support
• Search and browse user snippets, likes, and forks
• Embed snippets in other websites
• View revisions history for each snippet
• Like and fork snippets
• Download raw files or as a ZIP archive
• Integrate with OAuth2 login from GitHub, GitLab, Gitea, and OpenID Connect
• Restrict or unrestrict snippets visibility to anonymous users

Getting Started:

Opengist can be easily set up using Docker. With just a few commands, you’ll have your own instance of Opengist running on port 6157, accessible at http://localhost:6157. Uses and Benefits

ghcr.io/thomiceli/opengist in Docker provides a self-hosted pastebin powered by Git, offering an open-source alternative to GitHub Gist. This allows users to:

• Create public, unlisted or private snippets
• Use standard Git commands or the web interface to manage snippets
• Enjoy syntax highlighting, markdown & CSV support, search code, and revisions history
• Like, fork, download, and embed snippets in other websites

The primary benefits of using ghcr.io/thomiceli/opengist include:

• Self-hosting: No reliance on external services, ensuring full control over data
• Open-source: Contributions and modifications are encouraged, promoting community growth
• Flexibility: Supports various protocols (HTTP/SSH) and authentication methods (OAuth2)
• Security: Snippets can be restricted or unrestricted to anonymous users for added security Docker Setup ================

Quickly set up ghcr.io/thomiceli/opengist in Docker with this easy guide.

Using docker-compose

1. Create a new file named docker-compose.yml and add the following content:

services:
  opengist:
    image: ghcr.io/thomiceli/opengist:1.7
    container_name: opengist
    restart: unless-stopped
    ports:
      - "6157:6157" # HTTP port
      - "2222:2222" # SSH port (optional)
    volumes:
      - "$HOME/.opengist:/opengist"

2. Run docker-compose up -d to start the container in detached mode.

Tips and Common Issues

• Make sure you have Docker and Docker Compose installed on your system.
• If you encounter issues with permissions, try setting a specific UID and GID for the container using environment variables (e.g., UID: 1001 and GID: 1001).
• You can customize the container’s configuration by modifying the docker-compose.yml file or passing additional flags to the opengist binary.

Verify the Setup

Open your web browser and navigate to http://localhost:6157 to access Opengist.

Security Essentials

Secure Docker Deployment

When running ghcr.io/thomiceli/opengist in Docker, consider the following security measures:

• Use a non-root user to run the container by setting UID and GID environment variables in your docker-compose.yml file. For example:

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

*   Mount a volume at `$HOME/.opengist:/opengist` to store configuration and data securely.
*   Make sure to keep your Docker images up-to-date by regularly pulling the latest version from `ghcr.io/thomiceli/opengist`.
*   Consider using a secure connection (HTTPS) for accessing Opengist instead of HTTP.

By following these guidelines, you can ensure a more secure deployment of **ghcr.io/thomiceli/opengist** in Docker.