{"name":"Zipline: A Feature-Rich ShareX and File Upload Server","description":"Zipline is a powerful and user-friendly ShareX and file upload server designed for easy setup and extensive functionality. It offers a wide array of features, including file management, URL shortening, and robust security options, making it an ideal solution for personal or team file sharing needs. Its Docker-based installation ensures a quick and efficient deployment process.","github":"https://github.com/diced/zipline","url":"https://osrepos.com/repo/diced-zipline","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/diced-zipline","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/diced-zipline.md","json":"https://osrepos.com/repo/diced-zipline.json","topics":["zipline","file-upload","sharex","docker","file-server","typescript","self-hosting","cloud-storage"],"keywords":["zipline","file-upload","sharex","docker","file-server","typescript","self-hosting","cloud-storage"],"stars":null,"summary":"Zipline is a powerful and user-friendly ShareX and file upload server designed for easy setup and extensive functionality. It offers a wide array of features, including file management, URL shortening, and robust security options, making it an ideal solution for personal or team file sharing needs. Its Docker-based installation ensures a quick and efficient deployment process.","content":"## Introduction\n\nZipline is presented as the next-generation ShareX and file upload server, built with TypeScript. It provides a comprehensive solution for managing and sharing files, screenshots, and more, with a strong emphasis on ease of use and a rich feature set. From simple file uploads to advanced features like URL shortening, custom themes, and robust security measures, Zipline aims to be a complete self-hosted file management platform. It supports various integrations, including Discord and HTTP webhooks, and offers flexible storage options, including local filesystem and S3 compatibility.\n\n## Installation\n\nThe recommended method for deploying Zipline is via Docker, which simplifies the setup process significantly. Below is a `docker-compose.yml` example to get started, including a PostgreSQL database service.\n\nyml\nservices:\n  postgresql:\n    image: postgres:16\n    restart: unless-stopped\n    env_file:\n      - .env\n    environment:\n      POSTGRES_USER: ${POSTGRESQL_USER:-zipline}\n      POSTGRES_PASSWORD: ${POSTGRESQL_PASSWORD:?POSTGRESSQL_PASSWORD is required}\n      POSTGRES_DB: ${POSTGRESQL_DB:-zipline}\n    volumes:\n      - pgdata:/var/lib/postgresql/data\n    healthcheck:\n      test: ['CMD', 'pg_isready', '-U', 'zipline']\n      interval: 10s\n      timeout: 5s\n      retries: 5\n\n  zipline:\n    image: ghcr.io/diced/zipline\n    ports:\n      - '3000:3000'\n    env_file:\n      - .env\n    environment:\n      - DATABASE_URL=postgres://${POSTGRESQL_USER:-zipline}:${POSTGRESQL_PASSWORD}@postgresql:5432/${POSTGRESQL_DB:-zipline}\n    depends_on:\n      postgresql:\n        condition: service_healthy\n    volumes:\n      - './uploads:/zipline/uploads'\n      - './public:/zipline/public'\n      - './themes:/zipline/themes'\n    healthcheck:\n      test: ['CMD', 'wget', '-q', '--spider', 'http://localhost:3000/api/healthcheck']\n      interval: 15s\n      timeout: 2s\n      retries: 2\n\nvolumes:\n  pgdata:\n\n\nBefore running, you need to generate essential secrets and store them in a `.env` file:\n\nbash\necho \"POSTGRESQL_PASSWORD=$(openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\\n')\" > .env\necho \"CORE_SECRET=$(openssl rand -base64 42 | tr -dc A-Za-z0-9 | cut -c -32 | tr -d '\\n')\" >> .env\n\n\nOnce the `.env` file is configured, start Zipline with:\n\nbash\ndocker compose up -d\n\n\nFor more detailed installation instructions, including manual setup and advanced configurations, refer to the <a href=\"https://zipline.diced.sh/docs/get-started/docker\" target=\"_blank\">official documentation</a>.\n\n## Examples of Use\n\nZipline excels in various file management scenarios:\n\n*   **ShareX Integration**: Seamlessly upload screenshots and files directly from ShareX, making it an ideal self-hosted alternative for quick content sharing.\n*   **File Hosting**: Host any type of file, organizing them into folders and tagging them for easy retrieval.\n*   **URL Shortening**: Beyond file uploads, Zipline can also function as a URL shortener, providing custom short links for any web address.\n*   **Media Management**: Automatically generate video thumbnails and compress images, optimizing content for web delivery.\n*   **Secure Sharing**: Protect sensitive uploads with password protection, ensuring only authorized users can access them.\n*   **Customization**: Personalize your upload server's appearance with custom themes, aligning it with your brand or preferences.\n\n## Why Use Zipline?\n\nChoosing Zipline offers several compelling advantages:\n\n*   **Feature-Rich**: It comes packed with an extensive list of features, from basic file uploads to advanced security, customization, and API capabilities.\n*   **Easy Setup**: The Docker-first approach ensures a quick and straightforward installation, getting your server up and running in minutes.\n*   **Self-Hosted Control**: Gain full control over your data and infrastructure, avoiding reliance on third-party services.\n*   **Security**: Implement robust security measures like 2FA, Passkeys, and password protection for your uploads.\n*   **Flexibility**: Supports both local storage and S3-compatible object storage, allowing you to scale your storage solution as needed.\n*   **Active Development**: The project is actively maintained and welcomes contributions, ensuring continuous improvement and new features.\n\n## Links\n\n*   **GitHub Repository**: <a href=\"https://github.com/diced/zipline\" target=\"_blank\">https://github.com/diced/zipline</a>\n*   **Official Documentation**: <a href=\"https://zipline.diced.sh\" target=\"_blank\">https://zipline.diced.sh</a>","metrics":{"detailViews":4,"githubClicks":5},"dates":{"published":null,"modified":"2025-12-23T16:01:19.000Z"}}