Small, lightweight pastebin+URL shortener written in Elixir using the Phoenix framework.
apicowboyelixiresbuildhacktoberfestnifno-javascriptpastebinphoenixpostgresqlrest-apirustshortenersyntax-highlighting
.github/workflows | ||
assets | ||
config | ||
lib | ||
native/ketbin_utils_syntax | ||
priv | ||
rel/overlays/bin | ||
test | ||
.dockerignore | ||
.formatter.exs | ||
.gitignore | ||
Dockerfile | ||
fly.toml | ||
Makefile | ||
mix.exs | ||
mix.lock | ||
README.md | ||
renovate.json | ||
sample.env | ||
startup.sh |
Katbin
To start your Phoenix server:
- Copy
config/dev.secret.sample.exs
toconfig/dev.secret.exs
- Fill in the SMTP and database configuration in
config/dev.secret.exs
- Install dependencies with
mix deps.get
- Create and migrate your database with
mix ecto.setup
- Install Node.js dependencies with
npm install
inside theassets
directory - Start Phoenix endpoint with
mix phx.server
Now you can visit localhost:4000
from your browser.
Self hosting
We recommend using our official docker image. If you wish to build your own docker image, the provided Dockerfile should work out of the box. If you run into any problems, please open an issue.
Populating the environment
Copy the provided sample.env
file to .env
cp sample.env .env
Fill in this new file with the required environment variables.
Using the official docker image
docker run --env-file .env atechnohazard/katbin-elixir
Building the docker image
git clone https://github.com/SphericalKat/katbin
cd katbin
docker build -t <username>/katbin .
Running the built docker image
docker run --env-file .env <username>/katbin
For other methods of self hosting, please check the official Phoenix deployment guides.
Learn more
- Official website: https://www.phoenixframework.org/
- Guides: https://hexdocs.pm/phoenix/overview.html
- Docs: https://hexdocs.pm/phoenix
- Forum: https://elixirforum.com/c/phoenix-forum
- Source: https://github.com/phoenixframework/phoenix