Custom apps

When the app you want isn’t in the library, you can add your own using a Docker Compose file. This covers anything that ships as a container.

Add a custom app

1. On the Apps page, choose Add custom app.
2. Give it a name, and optionally a description and an icon.
3. Paste your docker-compose.yml. This defines the services, image, and environment the app runs with.
4. Set ports, environment variables, and a network if the app needs them.
5. Create and run.

The app then behaves like any other installed app: start and stop it, read its logs, point it at folders, and back it up. See Install & manage apps.

Caution

A custom app runs the image and configuration you provide. Use Compose files and images you trust, and keep secrets (passwords, API keys) in environment variables rather than committing them anywhere shared.

Folders and ports

Map folders the same way as a library app: a Compose volume that points at a host path becomes a folder you assign in Bitsmith. Expose a port to reach the app’s web interface at your server’s address.