Creating Users

Yew Search does not currently have a web-based onboarding or user registration process. This is intentional for the pre-alpha stage. All users must be created using the CLI (command-line interface) after installing the application. Future versions will include a proper onboarding flow, but for now, administrators create users directly through the backend container.

Creating Your First User

Yew Search has two ways to create your first user, the web interface after the first installation and via the CLI.

Web Interface

After you first deploy Yew Search on your homelab you can navigate in a browser to [your Yew Search frontend IP]/#!/bootstrap. At that page you will see the first time setup interface. Fill this out and a new user will be created.

CLI

After deploying Yew Search with Docker Compose, create your first user by executing the CLI command inside the running backend container:

docker exec -it yew-backend pnpm run cli user:create --email="admin@example.com" --name="Admin User"

You will be prompted to enter a password (input will be masked with * characters). Once completed, you can log in to the Yew Search web interface using the email and password you just created.

Additional CLI Commands

For a complete list of available CLI commands including password reset and user management, see List of CLI Commands.