---

Polarite is a Pastebin alternative made for simplicity written in Go.

Usage

API

Send a POST request to https://polarite.teknologiumum.com with:

• Content-Type header with the value of text/plain
• Non-empty request body consisting of the text you want to store
• Authorization header with the value of Your Name <your email> with a minimum of 15 characters.

Example request:

• cURL

curl \
    -H "Content-Type: text/plain" \
    -H "Authorization: John Doe <[email protected]>" \
    -X POST \
    -d "Hello World" \
    https://polarite.teknologiumum.com/

• Javascript (via Fetch API)

fetch("https://polarite.teknologiumum.com/", {
    method: "POST",
    headers: {
        "Content-Type": "text/plain",
        "Authorization": "John Doe <[email protected]>"
    },
    body: "Hello world!"
})

• Go

import (
    "net/http"
    "strings"
)

func Polarite() {
    body := strings.NewReader("Hello world")
    req, err := http.NewRequest(http.MethodPost, "https://polarite.teknologiumum.com/", body)
    req.Header.Add("Content-Type", "text/plain")
    req.Header.Add("Authorization", "John Doe <[email protected]>")

    client := &http.Client{}
    resp, err := client.Do(req)
}

• C#

using System.Net.Http;

var client = new HttpClient();
var request = new HttpRequestMessage() {
    RequestUri = new Uri("https://polarite.teknologiumum.com/"),
    Method = HttpMethod.Post,
    Headers = {
        { "Authorization", "John Doe <[email protected]>" },
        { "ContentType", "text/plain" }
    },
    Content = new StringContent("Hello world", Encoding.UTF8, "text/plain")
};

var task = await client.SendAsync(request);

Available Options

Polarite uses alecthomas/chroma. You can pass some options to the highlighter by appending these parameters in the URL. If none of these options are passed, you will get a plain text without any highlighting

• lang

  This option decides which language to use. See alecthomas/chroma#supported-languages for supported languages.

  • https://polarite.teknologiumum.com/your-unique-id?lang=go
  • https://polarite.teknologiumum.com/your-unique-id?lang=rust

• theme

  This option decides which theme to use. The default theme is dracula.

  • https://polarite.teknologiumum.com/your-unique-id?theme=monokai
  • https://polarite.teknologiumum.com/your-unique-id?theme=nord
  Click here to see all valid themes

  • abap
  • algol
  • algol_nu
  • arduino
  • autumn
  • base16-snazzy
  • bw
  • borland
  • colorful
  • doom-one
  • doom-one2
  • dracula
  • emacs
  • friendly
  • fruity
  • github
  • hrdark
  • hr_high_contrast
  • igor
  • lovelace
  • manni
  • monokai
  • monokailight
  • murphy
  • native
  • nord
  • onesenterprise
  • paraiso-dark
  • paraiso-light
  • pastie
  • perldoc
  • pygments
  • rainbow_dash
  • rrt
  • solarized-dark
  • soldarized-dark256
  • solarized-light
  • swapoff
  • tango
  • trac
  • vim
  • vs
  • vulcan
  • xcode
  • xcode-dark

• linenr

  This option decides whether to enable line number or not. A non empty value is considered as true.

  • https://polarite.teknologiumum.com/your-unique-id?linenr=yes
  • https://polarite.teknologiumum.com/your-unique-id?linenr=true This is also valid

You can, of course, combine the options. For example: https://polarite.teknologiumum.com/your-unique-id?lang=rust&theme=nord&linenr=true

Self-hosting Installation

We only provide Docker as a self-hosting option. You can build the image from source if you want it.

Docker

docker run -d -p 3000:3000 ghcr.io/teknologi-umum/polarite:latest

If you want to use the image from master branch, you can use :edge tag instead of :latest.

Docker Compose

services:
  polarite:
    image: ghcr.io/teknologi-umum/polarite:latest
    ports:
      - 3000:3000
    environment:
      ENVIRONMENT: production
      PORT: 3000
      TZ: UTC
      SENTRY_DSN: ""
      DATABASE_DIRECTORY: /app/data
    healthcheck:
      test: curl -f http://localhost:3000/ || exit 1
      interval: 15s
      timeout: 10s
      retries: 5

If you want to use the image from master branch, you can use :edge tag instead of :latest.

Why the name, Polarite?

In the dawn of time, it began with the birth of Graphene repository, which its' name was picked from the name of a mineral. Then, not so long after, another repository called Flourite emerged. It's actually a typo of Fluorite, another name of a mineral. Now, where mankind stands, we want to continue that convention, to pick a name from a list of mineral on Wikipedia.

License

Copyright 2025 Teknologi Umum <[email protected]>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

See LICENSE