ted-vo / seelf

Lightweight self-hosted deployment platform written in Go

seelf : Painless self-hosted deployment platform

I mean, for real!

seelf-presentation.mov

The seelf initial public version has some limitation (only local Docker engine, single user mostly) but you can check out the roadmap to see what's planned!

Goal

Got an already working docker compose file for your project ? Just send it to your seelf instance and boom, that's live on your own infrastructure with all services correctly deployed and exposed on nice urls as needed! See the documentation for more information.

Althought Docker is the only backend supported at the moment, I would like to investigate to enable other ones too. Remote Docker or Podman for example.

Prerequisites

• Docker
• A DNS correctly configured (with a wildcard redirecting to where seelf is hosted)

Quick start

Want to give seelf a try?

docker run -d -e "[email protected]" -e "SEELF_ADMIN_PASSWORD=admin" -v "/var/run/docker.sock:/var/run/docker.sock" -v "seelfdata:/seelf/data" -p "8080:8080" yuukanoo/seelf

Head over http://localhost:8080 and sign in using [email protected] and admin as password!

To quickly check how seelf behaves, you can use examples packaged as .tar.gz archives in this repository.

See all available options in the documentation to get more serious and configure seelf for your server.

Documentation

See the documentation in this repository. If you need more help, feel free to open an issue!

Contributing

Oh nice! Let's build together!

The Makefile contains some target such as:

• make serve-front: run the dashboard UI for development
• make serve-back: serve the backend API
• make test: launch all tests
• make ts: print the current timestamp (mostly used when creating migrations)
• make build: build seelf for the current platform

Note: on Windows, you will need a gcc compiler such as tdm gcc to build the sqlite3 driver correctly.

Architecture

See the architecture overview.