#akkoma-basic-alpine

If your are looking for the official akkoma provided docker images, click here

Unofficial Akkoma docker image based on Alpine Linux, focused on putting as many files into the docker file as possible, to reduce the hassle of git fetching the latest stable version and breaking your instance in the process.

Sound like a /me/ problem - I known, but that is why I created this image.

#Usage

You can auto-deploy this image using docker-compose:

docker compose build
docker compose up

or use the pre-built images available on codeberg.

#Configuration

Initial configuration can be done using environment variables.

#Post-installl

After starting your server, you might want to install the UI or setup users.

To do so, you have to connect to the running akkoma container, by running the following command:

docker container exec -it <container-name/id> /bin/ash

Afterwards you can access the pleroma commands from the containers shell.

If you don't know the container name, have a look at the list of all running containers and try to find the akkoma container, which is using the akkoma-basic-alpine image:

docker container ls

#Creating a user

Users can be created using the pleroma_ctl command:

/akkoma/bin/pleroma_ctl user new <nickname> <email> [option ...]

For more information, refer to the official documentation

#Installing frontends

Frontends can be installed using the pleroma_ctl command:

/akkoma/bin/pleroma_ctl frontend install <frontend>

For example to install pleroma-fe and the admin-fe frontends:

# pleroma-fe
/akkoma/bin/pleroma_ctl frontend install pleroma-fe --ref stable
# admin-fe
 /akkoma/bin/pleroma_ctl frontend install admin-fe --ref stable

Additional information is available in the official documentation

#Updating

Turn off the docker container

docker container stop <container-name/id>

Afterwards update the image by rebuilding it, or pulling the prebuilt.

And start your container again.