Home

Awesome

<img align="left" width="100" height="100" style="border-radius: 15%" src="branding/logo/picsur.svg"/> <a href="https://discord.gg/GPZNwV3VKE"> <img align="right" style="margin: 5px" src="https://img.shields.io/discord/986634827337965638?color=454FBF&label=Chat%20on%20Discord"/> </a>

Picsur

Totally not an Imgur clone

I couldn't really find any open source project that allowed you to easily host images. So I decided to create one.

It feels like a hybrid between Imgur and Pastebin.

Beta

Right now this software is still in beta, and many things are still missing, or will be changed in the future. But it does function, so feel free to give it a try.

Demo

You can view a live demo here: https://picsur.org/

The images are deleted every five minutes, and the maximum filesize is 16MB. But it should give you an indication of how it works.

Features

Here is a list of done features, and what is planned. For a more detailed list, you can always visit the project.

Every featured marked here should work in the latest release.

Bugs

If you encounter any bugs or oddities, please open an issue here. Cause without feedback I'll never know they exists.

Star

If you like this project, don't forget to give it a star. It tells me that I'm not wasting my time on something that people don't like.

Faq

Is this project maintained?

Yes it still is. If I were to stop maintaining it, I would archive the repository.

However I do not have a lot of time on my hands, so updates are not always as frequent as I would like them to be.

Why do my images dissapear of the public instance?

The public instance is only a demo, and therefore only keeps images for 5 minutes. This is to prevent the server from running out of disk space, and to prevent people from using it to host questionable images.

If you wish to keep your images, you will have to host your own instance.

How do I allow users to register their own accounts?

By default, users can't register their own accounts. This is to prevent users from accidentally allowing anyone to upload to their instance.

If you want to allow this you can though. To change this you go to settings -> roles -> guest -> edit, and then give the guest role the Register permission. Upon saving the role, the register button will appear on the login page.

I want to keep my original image files, how?

By default, Picsur will not keep your original image files. Since for most purposes this is not needed, and it saves disk space.

If you want to enable this however, you can do so by going to settings -> general, and then enabling the Keep original option. Upon saving the settings, the original files will be kept.

Do keep in mind here, that the exif data will NOT be removed from the original image. So make sure you do not accidentally share sensitive data.

This service says its supports the QOI format, what is this?

QOI is a new lossless image format that is designed to be very fast to encode and decode. All while still offering good compression ratios. This is the primary format the server will store images in when uploaded.

You can read more about QOI here.

What is the default admin login?

The default username is admin, and the default password is set from the PICSUR_ADMIN_PASSWORD environment variable.

I get "Copying to clipboard failed"

It is only possible to use the clipboard functionality on HTTPS websites or localhost. Please ensure you are running Picsur with HTTPS.

Running your own instance

You easily run this service yourself via Docker. Here is an example docker-compose file:

version: '3'
services:
  picsur:
    image: ghcr.io/caramelfur/picsur:latest
    container_name: picsur
    ports:
      - '8080:8080'
    environment:
      # PICSUR_HOST: '0.0.0.0'
      # PICSUR_PORT: 8080

      PICSUR_DB_HOST: picsur_postgres
      # PICSUR_DB_PORT: 5432
      # PICSUR_DB_USERNAME: picsur
      # PICSUR_DB_PASSWORD: picsur
      # PICSUR_DB_DATABASE: picsur

      ## The default username is admin, this is not modifiable
      # PICSUR_ADMIN_PASSWORD: picsur

      ## Optional, random secret will be generated if not set
      # PICSUR_JWT_SECRET: CHANGE_ME
      # PICSUR_JWT_EXPIRY: 7d

      ## Maximum accepted size for uploads in bytes
      # PICSUR_MAX_FILE_SIZE: 128000000
      ## No need to touch this, unless you use a custom frontend
      # PICSUR_STATIC_FRONTEND_ROOT: "/picsur/frontend/dist"

      ## Warning: Verbose mode might log sensitive data
      # PICSUR_VERBOSE: "true"
    restart: unless-stopped
  picsur_postgres:
    image: postgres:17-alpine
    container_name: picsur_postgres
    environment:
      POSTGRES_DB: picsur
      POSTGRES_PASSWORD: picsur
      POSTGRES_USER: picsur
    restart: unless-stopped
    volumes:
      - picsur-data:/var/lib/postgresql/data
volumes:
  picsur-data:

Thanks

Api

Here is a usually up to date documentation of the api:

Run in Postman

If you wish to build your own frontend or app for picsur, this will surely come in handy. Also take a look at the ./shared folder in the source code, as it contains typescript schema definitions for the api.