L Lomi documentation

Lomi source package

Set up the server

Start a local Lomi API and admin console, then check each part before moving to the app.

Before you start

What you need

  • A computer with Docker Engine and the Docker Compose plugin installed and running.
  • Enough free disk space for Docker images and uploaded media. Video processing and stored media can grow substantially.
  • Internet access for the first container build.
  • Terminal access in the unzipped server/backend folder.

Docker builds the Go API and Nuxt admin panel from source. You do not need to install Go or Node on the machine for this local Docker path.

Diagram of terminal setup, Docker services, health check and admin page
The local setup flow; boxes are illustrations, not live screenshots. Select the image to open it full size.

Local installation

Run the server

1

Open a terminal in the backend folder

From the unzipped package root, enter:

cd server/backend

On Windows, use a terminal with Docker available, such as PowerShell or WSL. The setup script uses a Unix shell; WSL or a Linux/macOS machine is the simplest path.

2

Start Docker, then run the setup script

sh scripts/setup.sh

The script creates a private server/backend/.env, builds the API and admin assets, applies database migrations and starts the containers. The first build downloads dependencies and may take several minutes. Keep .env private.

3

Check the API

curl http://127.0.0.1:8080/health/ready

A healthy response confirms that the API can start. If it fails, inspect container logs:

docker compose ps
docker compose logs api worker moderation migrate
4

Open the admin console

Open http://localhost:8080/admin/ on the same computer. The first-run wizard checks requirements, license, database and owner account.

Important gate

Admin license step

Illustration of admin requirements, license, database and owner steps
The admin wizard uses an activation key tied to your installation ID and admin origin. Select the image to open it full size.
1

Copy your installation ID

The wizard shows an ID in the License step. Copy it exactly. The setup script already configures the public verification key for local setup.

2

Issue your key from the paid checkout

Return to your paid checkout order, or recover it with the paying wallet and transaction hash. In Get your activation key, paste the installation ID and use http://localhost:8080 as the admin origin. Select Issue activation key.

3

Finish the wizard

Copy the resulting key into the License key field and continue. A production deployment needs its own key bound to its exact HTTPS admin origin and installation ID. Your order includes one local development key and one production key. For a transfer, email lomi@amixmon.com.

Never paste a private signing key into the browser, repo or package. Only Amixmon holds the private signing key.

After local setup

Plan a public deployment

The local setup listens on loopback and is not a public internet deployment. Before accepting users, arrange:

  • A domain and HTTPS reverse proxy for the API and admin console.
  • Strong private database credentials and access limited to the server.
  • Persistent media storage with off-server backups, and a tested restore.
  • Production signing and provider configuration for the Android app.
  • A signed installation entitlement and verification of your production origin.
  • Monitoring, email delivery credentials if using recovery email, and an operational security review.

Use server/backend/README.md and server/docs/ for implementation details. The local setup script does not provision a public domain, HTTPS or backups.

Preserve data: Do not use docker compose down -v to update an installation; the -v flag removes persistent volumes.