feat(service): add apache superset service

[nktnet1]

Changes

• added AirBnB's Apache/Superset (unofficial) template

Update 20/05/2025 - Added video demo:

superset-coolify-56mb.webm

---

Apache Superset is a popular "Data Visualization and Data Exploration Platform". Currently, it has ~64k stars on GitHub.

Unfortunately, superset does not officially support docker-compose in production:

• https://superset.apache.org/docs/installation/docker-compose

---

This template uses an unofficial docker image to allow for production docker deployment. However, this in itself is also quite popular, with nearly 1k stars on GitHub:

• https://github.com/amancevice/docker-superset

and over 5 million downloads on DockerHub:

• https://hub.docker.com/r/amancevice/superset

---

There are multiple flavours of superset (unofficial) that are supported, e.g.

• celery
• postgresql (I chose this one)
• mysql
• sqlite (probably not prod)

However, given that it's "unofficial", I wanted to run this through the Coolify team before proceeding with the superset-unofficial-with-celery and superset-unofficial-with-mysql templates, in case the policy is to not accept unofficial images.

---

NOTE: for the first launch, you will need to enter the superset container using Coolify's terminal feature to run

superset-init

to register the admin user and database. Alternatively, the superset-demo command will do the same, and additionally load demo database/charts/dashboards into the superset instance.

I'm happy to contribute this to documentations-coolify if it gets the green light.

---

[andrasbacsai]

It was a mistake, sorry. I recreated the next branch and it auto-closed this PR.

[peaklabs-dev]

Thanks for the PR. I think this is not fully working just yet. When running superset init it throws and error and also there is no user created via ENVs as far as I know, so nobody can log in can you please fix these things.

[nktnet1]

Hey @peaklabs-dev,

Are you able to show me the error you're getting from superset-init? (note the -)

Our team actually has this template running in production, so that's odd. I'll try again to see if anything changed in the latest docker image.

also there is no user created via ENVs as far as I know, so nobody can log in can you please fix these things

I don't think superset supports creating an admin user through ENV - it must be done through the superset init command.

[nktnet1]

@peaklabs-dev yep, tested it just now and it works.

I also tested superset init instead of superset-init, and it does result in the error I assume you were getting. This is because you need to run a few other commands before that.

Here's what the docker version's superset-init command runs:

• https://github.com/amancevice/docker-superset/blob/1ea7d1ad124fb7f1d1ca951e0b07fdf7e08b29bc/bin/superset-init

#!/bin/bash
set -eo pipefail

# Create an admin user
flask fab create-admin $@

# Initialize the database
superset db upgrade

# Create default roles and permissions
superset init

Demo:

superset-coolify-56mb.webm

[peaklabs-dev]

Thanks. Maybe you can add an entrypoint script that runs this automatically?

[nktnet1]

Thanks. Maybe you can add an entrypoint script that runs this automatically?

I think that might work, but I'm hesitant because

1. it goes against superset's setup instructions, i.e. will need to be managed and maintained by Coolify and could cause confusion
2. it takes away some flexibility, e.g. loading demos instead of the basic init
3. we'll need to find a way to avoid running the setup (or exit early) each time the container restarts

If you're happy with the above, then I can help look into it.
Not sure if there will be an easy way to do number 3 though.

[peaklabs-dev]

I guess it make sense not to automate it. Can you create a docs PR that tells the user to run superset-init in the superset Container and then everything will work (just tried it and that works perfectly)

Thanks for the PR. I will merge it and fix a few small things.

[nktnet1]

Documentation added here:

• docs(service): superset information and usage coolify-docs#289