Quick Start

Get можно. running in 5 minutes with Docker Compose.

Step 1: Create docker-compose.yml

services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: feature_flags
      POSTGRES_USER: flags_user
      POSTGRES_PASSWORD: flags_password
    volumes:
      - pgdata:/var/lib/postgresql/data

  mozhno:
    image: mozhnodev/mozhno:latest
    ports:
      - '8080:8080'
    environment:
      MOZHNO_DB_URL: jdbc:postgresql://postgres:5432/feature_flags
      MOZHNO_DB_USERNAME: flags_user
      MOZHNO_DB_PASSWORD: flags_password
      MOZHNO_JWT_SECRET: ${MOZHNO_JWT_SECRET:-}
      MOZHNO_INIT_EMAIL: ${MOZHNO_INIT_EMAIL:-admin@admin.com}
      MOZHNO_INIT_PASSWORD: ${MOZHNO_INIT_PASSWORD:-admin}
    depends_on:
      - postgres

volumes:
  pgdata:

Step 2: Start the server

docker compose up -d

Step 3: Open the web dashboard

Navigate to http://localhost:8080.

Step 4: Log in

On first launch, the server bootstraps an admin user and a default project from the MOZHNO_INIT_EMAIL and MOZHNO_INIT_PASSWORD environment variables. Defaults are admin@admin.com / admin.

1. Open http://localhost:8080
2. Log in with the credentials from MOZHNO_INIT_EMAIL / MOZHNO_INIT_PASSWORD
3. Change the password immediately — go to «Users» → «Edit»

You will land in the dashboard with a ready-to-use "Default Project".

Step 5: Get your API key

1. In the dashboard, go to "API Keys"
2. Click "Create Key"
3. Enter a name (e.g., my-app)
4. Select type SERVER and the Production environment
5. Copy the key value — it is shown only once

Step 6: Add the flag to your code

Java

Add the dependency to build.gradle:

repositories { mavenCentral() }
dependencies { implementation 'dev.mozhno:mozhno-client-java:1.1.1' }

import dev.mozhno.sdk.*;

var config = MozhnoConfig.builder()
    .appName("my-app")
    .instanceId("instance-1")
    .mozhnoUrl("http://localhost:8080")
    .apiKey("your-api-key")  // API key from «API Keys» in the dashboard
    .build();

var client = new DefaultMozhnoClient(config);
client.start();

var ctx = MozhnoContext.builder().userId("user-123").build();
boolean isEnabled = client.isEnabled("new-checkout", ctx);

if (isEnabled) {
    // new code
} else {
    // old code
}

JavaScript / TypeScript

Install the package:

npm install @mozhno/client-js

What's Next?

• Installation — manual setup and production configuration
• Configuration — all environment variables
• Flags — learn about flag types and rules