A pastebin clone written in Elixir/Phoenix.
Exbin
A pastebin clone written in Phoenix/Elixir. Live here.
I work on this project from time to time, so the development pace is slow. If you want to dive in, feel free. The codebase is relatively small because, well, it's a simple application.
Features
nc
to pipe text and get back the URL.
(e.g., cat file.txt | nc exbin.call-cc.be 9999
)Installation
The easiest way to run your own instance of Exbin is by running it in a Docker container.
Environment var Description Default
SECRET_KEY_BASE
Secret hash to encrypt traffic. Generate with mix phx.gen.secret
or openssl rand 64 | openssl enc -A -base64
.
Required
SECRET_SALT
Secret hash to encrypt traffic. Generate with mix phx.gen.secret
or openssl rand 64 | openssl enc -A -base64
.
Required
DATABASE_HOST
Host for database.
Required
DATABASE_DB
Name of the database.
Required
DATABASE_USER
Username for Postgres instance.
Required
DATABASE_PASSWORD
Password for Postgres user.
Required
POOL_SIZE
Concurrent database connections.
10
TZ
TZ database name
Required
EPHEMERAL_AGE
Ephemeral age of snippets in minutes.
60
HTTP_PORT
Port for HTTP endpoint.
4000
TCP_PORT
Port for the TCP endpoint.
Required
TCP_HOST
IP to bind on for TCP socket.
Required
MAX_SIZE
Maximum size in bytes for the TCP endpoint.
Required
DEFAULT_VIEW
Standard view for snippets. (Supported values are 'code', 'reader', or 'raw')
Required
BASE_URL
Base URL for this instance. Necessary behind a reverse proxy. E.g., https://example.com
.
Required
HOST
Hostname for this instance. E.g., example.com
.
Required
API_KEY
Password token for the API. If not set, the API is publicly available.
Optional
BRAND
Name of the Exbin instance. Shown in bottom right corner when creating a snippet.
Exbin
CUSTOM_LOGO_PATH
The full path on the host machine to your custom logo. E.g. "/srv/exbin/my_logo.png"
Optional
CUSTOM_LOGO_SIZE
The pixel dimensions of your logo, which is assumed to be square. Ignored if no logo set.
30
SMTP_RELAY
SMTP relay for the mailer.
Required
SMTP_USER
SMTP username for the mailer.
Required
SMTP_PASSWORD
SMTP password for the mailer.
Required
SMTP_PORT
SMTP port for the mailer.
Required
SMTP_FROM
SMTP sender address for the mailer.
Required
HTTPS
Boolean indicating this app will be served over HTTPS (e.g., reverse proxy)
true
DEBUG
Enable debug logging. Set to "true" to enable.
""
Create an .env file and give a value to all these environment variables. You can leave the ones with default values as is, if you want. An example is shown below.
SECRET_KEY_BASE=TUvAjMKpIXf+ik05cgmjErbtWVUBmKX70TCtg9ToU3ZC8gdNQoYnCrLAljBuHvKU
SECRET_SALT=Qrw8mzDAAdvouNi6EvP/vEBwgPw0lCXh2dCANXKbW0HnQElvhB8nETC/q/L+zxxa
DATABASE_HOST=db
DATABASE_DB=exbin
DATABASE_USER=postgres
DATABASE_PASSWORD=postgres
POOL_SIZE=10
TZ=Europe/Brussels
EPHEMERAL_AGE=60
HTTP_PORT=5000
TCP_PORT=9999
TCP_HOST=0.0.0.0
MAX_SIZE=2048
DEFAULT_VIEW=code
BASE_URL=https://example.com
HOST=example.com
DATABASE_DATA=/tmp/exbindata
API_KEY=mysupersecretkey
BRAND=Exbin
CUSTOM_LOGO_PATH=/exbin_branding/my_cool_logo.png
CUSTOM_LOGO_SIZE=50
SMTP_USER=test@example.com
SMTP_PASSWORD=supersecretyes
SMTP_PORT=465
SMTP_FROM=ebin@example.com
SMTP_RELAY=mail.example.com
HTTPS=true
Copy the docker-compose.yaml
file, and change accordingly. Finally, run it with docker-compose up
.
Initial User Account
When installing/running ExBin for the first time, a user will be created for you. It is highly recommended that you change this user its email and password. Look for a line like this in the log files.
Created a user with email admin@exbin.call-cc.be and password ccbbf2726ac2ce3d3918
If there are already users present in the database no user will be created. The logfile will show this.
Did not create a user because there are already registered users in the database.
The first user is the only admin user possible. I should probably update this in the future, but not today. If you already have a bunch of users, you can easily change it by toggling the flag in the database.
Custom Branding in Docker
In order to configure this you will need to mount the file into your docker container as a volume, and then set the CUSTOM_LOGO_PATH environment variable to the full path (inside the container) that the file is mounted at.
Here is an example of what you would add to your docker-compose.yml:
services:
exbin:
environment:
CUSTOM_LOGO_PATH=/exbin_branding/my_cool_logo.png
CUSTOM_LOGO_SIZE=50
volumes:
- /path/on/docker/host/my_logo.png:/exbin_branding/logo.png
Logo by default is 30x30 pixels, but you can define the size for the width/height attributes of the img tag by setting CUSTOM_LOGO_SIZE.
Logos are assumed to be square, so the same value will be used for both height and width.
Any layout errors that come from using sizes other than 30x30 are your problem. :-)
JSON API
There is a JSON API available. If your install has an API key set (the API_KEY
environment variable), it is required to post through the API. If it is not set, the API can be freely used.
The payload of the API is JSON, and expects at least the content of the snippet.
The api/new
endpoint expects a JSON payload with the keys content
, private
, and ephemeral
. For example:
{"content": "this is the content",
"private": true,
"ephemeral": false
}
An example request for a snippet without authentication looks like this.
$ curl -XPOST -H "Content-type: application/json" -d '{"content": "this is the content", "private": true, "ephemeral": false}' 'https://exbin.call-cc.be/api/new'
{"content":"this is the content","created":"2021-10-01T20:32:38.702101Z","name":"RegelatedDoublemindedness","url":"https://exbin.call-cc.be/RegelatedDoublemindedness"}
To use an authenticated endpoint simply add another field to the JSON payload with the token.
$ curl -XPOST -H "Content-type: application/json" -d '{"content": "this is the content", "private": true, "ephemeral": false, "token": "supersecret"}' 'https://exbin.call-cc.be/api/new'
{"content":"this is the content","created":"2021-10-01T20:32:38.702101Z","name":"RegelatedDoublemindedness","url":"https://exbin.call-cc.be/RegelatedDoublemindedness"}
A snippet can be requested by name using the api/new
endpoint. No parameters should be given.
An example curl request looks like this.
curl 'https://exbin.call-cc.be/api/show/CoppingSuctions'
{"content":"this is the content","created":"2022-05-06T08:40:17.769579Z","name":"CoppingSuctions","url":"https://exbin.call-cc.be/api/show/CoppingSuctions"}
Things To Do
👥 Contributors
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.