Cerrado

Self host single user forge.

You can find a running instance here:

https://beta.gabrielgio.me

Goals

Keep it simple and lightweight, that includes the application itself, development process and the deployment.

The application requires no javascript to run, and it is light and fast to render.

This project is also easy to iterate on. There are only two dev dependencies: go and sassc so it compiles fast. Codewise it strives for easy to understand. Easy to read code is better than clever.

The deployment process should be easy to wrap the head around and straightforward to set up. To achieve that it uses a simple file format¹ to configure everything. Also to reduce the moving parts the whole application, including its statics files, is bundled into a single binary.

To run the project you just need to make run.

Installations

One installation process available is through my apk repository²³.

You could also run:

make
make install

Or you could also pick another prefix:

PREFIX=$HOME/.local/ make install

You can check openrc files for the details how it is run with a init system, but in general you'd need the cerrado binary and scfg file, which can easily be integrated with systemd.

Contributing

To discuss about the project send me a email or write an issue on codeberg⁴. To avoid duplicated work or to work something I might not take in, I'd recommend to reach me before doing something.

To contribute code feel free to create a PR on codeberg or send me an email-patch⁵.

My email:

mail@gabrielgio.me

TODO

• dark theme that does not require js

Ideas

• Code snippet support
• Setup manual (man feature perhaps?)
• Add metrics
• Add reference based cache system. Cerrado should be able to cache the whole page based on its reference hash

Future

• Mail patch / mailing list. This is very complex endeavour. In a distant future I might do it, but for now I will focus on the features listed above.

---

1. https://git.sr.ht/~emersion/scfg ↩︎

2. https://apkdoc.gabrielgio.me/ ↩︎

3. https://git.gabrielgio.me/apkbuilds/ ↩︎

4. https://codeberg.org/gabrielgio/cerrado/issues ↩︎

5. https://git-send-email.io/ ↩︎